changelogkit 0.1.0__py3-none-any.whl

changelogkit/__init__.py

@@ -0,0 +1,11 @@
+"""changelogkit：本機變更歷史 GUI 與開發索引。
+
+通用工具，與任何特定 repo 解耦：
+
+* 變更歷史 — 解析 ``Docs/ChangeHistory.md``（可設定路徑），提供網頁 GUI 與 CLI。
+* 開發索引 — 唯讀索引 Git 近期改動（可展開 diff）、Swift 宣告定位、Markdown 文件。
+
+每個 repo 的差異由 repo 根目錄的 ``.changelog.toml`` 提供；未提供時用預設值。
+"""
+
+__version__ = "0.1.0"

changelogkit/__main__.py

@@ -0,0 +1,6 @@
+"""``python -m changelogkit`` 的進入點（等同 CLI 指令 ``changelogkit``）。"""
+
+from .cli import main
+
+if __name__ == "__main__":
+    main()

changelogkit/assets/about.html

@@ -0,0 +1,37 @@
+<!doctype html>
+<html lang="{{lang_html}}"><head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+<title>{{t.about.title}}</title>
+<script src="/assets/theme.js"></script>
+<script src="/assets/i18n.js"></script>
+<script>window.CK_I18N = {{i18n_json}};</script>
+<link rel="stylesheet" href="/assets/theme.css">
+<style>
+  main { max-width: 720px; margin: 0 auto; padding: 24px }
+  .card dl { display: grid; grid-template-columns: 120px 1fr; gap: 8px 16px; margin: 10px 0 0 }
+  .card dt { color: var(--mut); font-size: 13px }
+  .card dd { margin: 0; overflow-wrap: anywhere }
+  .card code { font-size: 13px }
+</style>
+</head><body>
+<header class="appbar">
+  <h1>{{t.about.title}}</h1>
+  <a href="/">{{t.nav.history}}</a>
+  <a href="/development">{{t.nav.dev}}</a>
+  <button id="theme" aria-label="{{t.btn.theme}}" title="{{t.btn.theme}}">🌙</button>
+</header>
+<main>
+  <article class="card">
+    <h2>changelogkit</h2>
+    <p class="muted">{{t.about.intro}}</p>
+    <dl>
+      <dt>{{t.about.version}}</dt><dd id="version">…</dd>
+      <dt>{{t.about.commit}}</dt><dd id="commit">…</dd>
+      <dt>{{t.about.locales}}</dt><dd id="locales">…</dd>
+      <dt>{{t.about.home}}</dt><dd><a href="https://github.com/TwhomeGH/ChangeLogKit">github.com/TwhomeGH/ChangeLogKit</a></dd>
+    </dl>
+  </article>
+</main>
+<script src="/assets/about.js"></script>
+</body></html>

changelogkit/assets/about.js

@@ -0,0 +1,22 @@
+/* 關於頁：向 /api/buildinfo 取版本與來源 commit（commit 連到 GitHub）。 */
+const REPO = "https://github.com/TwhomeGH/ChangeLogKit";
+
+fetch("/api/buildinfo")
+  .then((r) => r.json())
+  .then((b) => {
+    document.getElementById("version").textContent = b.version || CK_T("about.na");
+    /* UI 語系清單，* 標示目前生效者。 */
+    document.getElementById("locales").textContent =
+      (b.locales || []).map((l) => l + (l === b.locale ? " *" : "")).join("   ");
+    const raw = b.commit || "";
+    if (!raw) {
+      document.getElementById("commit").textContent = CK_T("about.unknown");
+      return;
+    }
+    const hash = raw.replace(/\+dirty$/, "");
+    document.getElementById("commit").innerHTML =
+      '<a href="' + REPO + "/commit/" + hash + '"><code>' + raw + "</code></a>";
+  })
+  .catch(() => {
+    document.getElementById("version").textContent = CK_T("about.load_failed");
+  });

changelogkit/assets/dev.css

@@ -0,0 +1,90 @@
+/* 開發索引頁面版面。主題與共用元件在 theme.css。 */
+main { max-width: 1100px; margin: auto; padding: 24px 28px 60px }
+#hint { margin: 4px 0 0 }
+#tabs { display: flex; gap: 8px; margin: 18px 0 6px; flex-wrap: wrap }
+#tabs button { white-space: nowrap }
+#tabs button[aria-pressed="true"] { background: var(--accent); color: var(--accent-fg); border-color: var(--accent) }
+#message { padding: 6px 0 10px; font-size: 13px }
+article.card h2 { margin: 0 0 6px; font-size: 19px; line-height: 1.35 }
+article.card h2 a { color: var(--fg); text-decoration: none }
+article.card h2 a:hover { color: var(--accent); text-decoration: underline }
+.meta { font-size: 12.5px; color: var(--mut); margin-bottom: 8px }
+.kind {
+  display: inline-block; font-size: 11px; font-weight: 700; letter-spacing: .03em;
+  padding: 1px 7px; border-radius: 6px; background: var(--code); color: var(--accent); margin-right: 6px;
+}
+.card dl { display: grid; grid-template-columns: 108px 1fr; gap: 6px 12px; margin: 10px 0 4px }
+.card dt { color: var(--mut); font-size: 13px } .card dd { margin: 0 }
+.card h3 { font-size: 13px; color: var(--mut); margin: 14px 0 6px; text-transform: none }
+.doc { line-height: 1.6 } .doc p { margin: .3em 0 } .doc ul { margin: .3em 0; padding-left: 1.3em }
+.files a { display: inline-block; margin: 0 12px 6px 0 }
+.preview { font: 13px/1.6 ui-monospace, Consolas, "Courier New", monospace; color: var(--mut); white-space: pre-wrap; overflow-wrap: anywhere; margin: 4px 0 0 }
+pre.blob { background: var(--code); border: 1px solid var(--line); border-radius: 10px; padding: 12px 14px; overflow: auto; font-size: 12.5px; line-height: 1.55 }
+.deps { display: grid; grid-template-columns: 1fr auto; gap: 6px 14px; margin-top: 6px }
+.deps code { font-size: 12.5px }
+@media (max-width: 640px) {
+  main { padding: 16px 16px 48px }
+  .card dl { grid-template-columns: 1fr }
+  .card dt { font-weight: 700 }
+}
+
+/* 「API 宣告」篩選列。 */
+#filters { margin: 4px 0 10px; display: flex; flex-direction: column; gap: 6px }
+#filters .supported { font-size: 12.5px; color: var(--mut); overflow-wrap: anywhere }
+#filters .chips { display: flex; flex-wrap: wrap; gap: 6px 8px }
+#filters .chip.on { background: var(--accent); color: var(--accent-fg); border-color: var(--accent) }
+#filters .kindfilter { font-size: 13px; color: var(--mut) }
+#filters .kindfilter select { width: auto; margin-left: 6px }
+
+/* 符號簽名列：等寬、可換行、深淺色一致。 */
+.sig {
+  margin: 6px 0 10px; padding: 9px 12px; border-radius: 10px;
+  background: var(--code); border: 1px solid var(--line);
+  color: var(--fg); font-size: 12.5px; white-space: pre-wrap;
+  word-break: break-word; overflow-x: auto;
+}
+
+/* 近期改動：提交卡片與差異檢視。 */
+.commits { display: flex; flex-direction: column; gap: 6px }
+.commit { border: 1px solid var(--line); border-radius: 10px; overflow: hidden; background: var(--bg) }
+.commit-head {
+  display: flex; flex-direction: column; gap: 3px; align-items: stretch; width: 100%;
+  text-align: left; background: transparent; border: 0; border-radius: 0; padding: 8px 12px;
+}
+.commit-head:hover { background: var(--line2) }
+.commit-top { display: flex; gap: 10px; align-items: baseline; flex-wrap: wrap }
+.commit-head .hash { color: var(--accent); font-size: 12.5px; background: none; padding: 0 }
+.commit-head .when { color: var(--mut); font-size: 12px; white-space: nowrap }
+.commit-head .subject { font-weight: 600; white-space: normal; overflow-wrap: anywhere }
+.commit-files { display: flex; flex-wrap: wrap; gap: 4px 14px; padding: 7px 12px; border-top: 1px solid var(--line2) }
+.commit-files a.cfile { font-size: 12px; color: var(--mut) }
+.commit-files a.cfile:hover { color: var(--accent) }
+.wt-wrap { margin: 6px 0 2px }
+.commit .diff, .wt-wrap .diff { padding: 8px 12px 10px }
+
+/* 統一分歧（unified diff）：等寬、可橫向捲動，+／- 綠紅底色。 */
+.dpre {
+  margin: 0; background: var(--code); border: 1px solid var(--line); border-radius: 10px;
+  overflow: auto; padding: 8px 0; white-space: pre;
+  font: 12.5px/1.55 ui-monospace, Consolas, "Courier New", monospace;
+}
+.dline { display: block; padding: 0 12px }
+.dmark { display: inline-block; width: 1.3em; color: var(--mut); user-select: none }
+.d-add { background: rgba(16, 185, 129, .14) }
+.d-del { background: rgba(239, 68, 68, .13) }
+.d-add .dmark { color: #059669 } .d-del .dmark { color: #dc2626 }
+.d-hunk { color: #8b5cf6; background: rgba(139, 92, 246, .08) }
+.d-file { color: var(--mut); font-weight: 600 }
+.d-meta { color: var(--mut) }
+
+/* 靜態匯出：<details class="commit">（動態版用 button.commit-head，故這些規則不衝突）。 */
+details.commit > summary { padding: 8px 12px; cursor: pointer }
+details.commit > summary::marker { color: var(--mut) }
+details.commit > summary:hover { background: var(--line2) }
+details.commit > summary .cbody { display: block }
+details.commit > summary .commit-top { display: flex; gap: 10px; align-items: baseline; flex-wrap: wrap }
+details.commit > summary .hash { color: var(--accent); font-size: 12.5px; background: none; padding: 0 }
+details.commit > summary .when { color: var(--mut); font-size: 12px; white-space: nowrap }
+details.commit > summary .subject { display: block; font-weight: 600; white-space: normal; overflow-wrap: anywhere }
+details.commit > .commit-files { border-top: 1px solid var(--line2) }
+details.commit > .dpre { margin: 8px 12px 10px }

changelogkit/assets/dev.html

@@ -0,0 +1,29 @@
+<!doctype html>
+<html lang="{{lang_html}}"><head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+<title>{{t.dev.title}}</title>
+<script src="/assets/theme.js"></script>
+<script src="/assets/i18n.js"></script>
+<script>window.CK_I18N = {{i18n_json}};</script>
+<link rel="stylesheet" href="/assets/theme.css">
+<link rel="stylesheet" href="/assets/dev.css">
+</head><body>
+<header class="appbar">
+  <h1>{{t.dev.title}}</h1>
+  <a href="/">{{t.nav.history}}</a>
+  <a href="/about">{{t.nav.about}}</a>
+  <input id="search" aria-label="{{t.dev.search}}" placeholder="{{t.dev.search}}">
+  <select id="repo" aria-label="{{t.dev.repo_all}}"><option value="">{{t.dev.repo_all}}</option></select>
+  <button id="reload" aria-label="{{t.dev.reload}}" title="{{t.dev.reload}}">↻</button>
+  <button id="theme" aria-label="{{t.btn.theme}}" title="{{t.btn.theme}}">🌙</button>
+</header>
+<main>
+  <p class="muted" id="hint">{{t.dev.hint}}</p>
+  <nav id="tabs"></nav>
+  <div id="message" role="status" class="muted">{{t.dev.loading}}</div>
+  <div id="filters" hidden></div>
+  <section id="results"></section>
+</main>
+<script src="/assets/dev.js"></script>
+</body></html>

changelogkit/assets/dev.js

@@ -0,0 +1,244 @@
+/* 開發索引：功能／API 宣告／文件／近期改動。資料來自 /development/data。 */
+const $ = (s) => document.querySelector(s);
+let data = null, tab = "features", lang = "", kind = "";
+
+const LABELS = {
+  features: "tab.features",
+  symbols: "tab.symbols",
+  documents: "tab.documents",
+  repos: "tab.repos",
+};
+
+function esc(s) {
+  return String(s ?? "").replace(/[&<>"']/g, (c) => (
+    { "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;", "'": "&#39;" }[c]
+  ));
+}
+
+/* 行內 markdown（用於註釋、摘要）：跳脫後套用 code/bold/link。 */
+function mdInline(s) {
+  s = esc(s);
+  s = s.replace(/`([^`]+)`/g, "<code>$1</code>");
+  s = s.replace(/\*\*([^*]+)\*\*/g, "<strong>$1</strong>");
+  s = s.replace(/\[([^\]]+)\]\(([^)]+)\)/g, '<a href="$2" target="_blank" rel="noopener">$1</a>');
+  return s;
+}
+
+/* 把相鄰 /// 註釋字串轉成簡單段落／條列。 */
+function mdDoc(text) {
+  if (!text) return "";
+  const lines = text.split("\n");
+  let out = "", list = [];
+  const flush = () => { if (list.length) { out += "<ul>" + list.map((x) => "<li>" + mdInline(x) + "</li>").join("") + "</ul>"; list = []; } };
+  for (const l of lines) {
+    const m = l.match(/^\s*[-*]\s+(.*)$/);
+    if (m) { list.push(m[1]); continue; }
+    flush();
+    if (l.trim()) out += "<p>" + mdInline(l) + "</p>";
+  }
+  flush();
+  return out;
+}
+
+function kindOf(name) {
+  const m = name.match(/\b(func|struct|class|enum|protocol|actor)\b/);
+  return m ? m[1] : "decl";
+}
+
+function links(items) {
+  return items.map((p) => `<a href="/development/file?repo=app&path=${encodeURIComponent(p)}">${esc(p)}</a>`).join("");
+}
+
+/* ── 近期改動：提交卡片與 lazy 差異 ── */
+
+function commitCard(repo, c) {
+  const files = (c.files || []).map((f) =>
+    `<a class="cfile" href="#" data-repo="${esc(repo)}" data-hash="${esc(c.hash)}" data-path="${esc(f)}">${esc(f)}</a>`
+  ).join("");
+  const when = (c.date || "").slice(0, 16).replace("T", " ");
+  return `<div class="commit" data-repo="${esc(repo)}" data-hash="${esc(c.hash)}">` +
+    `<button class="commit-head" type="button"><span class="commit-top"><code class="hash">${esc(c.hash)}</code>` +
+    `<span class="when">${esc(when)}</span></span>` +
+    `<span class="subject">${esc(c.subject)}</span></button>` +
+    `<div class="commit-files">${files || `<span class="muted">${CK_T("dev.no_files")}</span>`}</div>` +
+    `<div class="diff" hidden></div></div>`;
+}
+
+function diffLineClass(l) {
+  if (l.startsWith("@@")) return "d-hunk";
+  if (l.startsWith("+++") || l.startsWith("---") || l.startsWith("diff --git")) return "d-file";
+  if (l.startsWith("+")) return "d-add";
+  if (l.startsWith("-")) return "d-del";
+  if (/^(index |new file|deleted file|similarity|rename |old mode|new mode|Binary files)/.test(l) ||
+      l.startsWith("\\ No newline")) return "d-meta";
+  if (l.startsWith(" ")) return "d-ctx";
+  return "d-plain";
+}
+
+function renderDiff(j) {
+  if (j.empty) return '<p class="muted">' + CK_T("dev.diff_empty") + "</p>";
+  const hl = window.HL;
+  const swift = hl ? hl.swift : (t) => esc(t);
+  const esc2 = hl ? hl.esc : esc;
+  const state = { block: false };
+  const body = j.diff.split("\n").map((l) => {
+    const cls = diffLineClass(l);
+    if (cls === "d-file") state.block = false;
+    if (cls === "d-add" || cls === "d-del" || cls === "d-ctx") {
+      const mark = l[0] || " ";
+      return `<span class="dline ${cls}"><span class="dmark">${esc2(mark)}</span>${swift(l.slice(1), state)}</span>`;
+    }
+    return `<span class="dline ${cls}"><span class="dmark"> </span>${esc2(l)}</span>`;
+  }).join("");
+  return '<pre class="dpre">' + body + "</pre>" +
+    (j.truncated ? '<p class="muted">' + CK_T("dev.diff_truncated") + "</p>" : "");
+}
+
+const diffCache = new Map();
+async function loadDiff(box, params) {
+  const qs = params.toString();
+  if (diffCache.has(qs)) { box.innerHTML = diffCache.get(qs); box.hidden = false; return; }
+  box.hidden = false;
+  box.innerHTML = '<p class="muted">' + CK_T("dev.diff_loading") + "</p>";
+  try {
+    const res = await fetch("/development/diff?" + qs);
+    const j = await res.json();
+    if (!res.ok) throw Error(j.error || res.statusText);
+    const html = renderDiff(j);
+    diffCache.set(qs, html);
+    box.innerHTML = html;
+  } catch (e) {
+    box.innerHTML = '<p class="empty">' + CK_T("dev.load_failed") + esc(e.message) + "</p>";
+  }
+}
+
+/* 「API 宣告」頁的篩選列：支援語言 + 語言 chips + 種類下拉。 */
+function renderFilters() {
+  const box = $("#filters");
+  if (tab !== "symbols") { box.hidden = true; box.innerHTML = ""; return; }
+  box.hidden = false;
+  const symbols = data.symbols || [];
+  const langs = [...new Set(symbols.map((s) => s.lang).filter(Boolean))];
+  const kinds = [...new Set(symbols.map((s) => s.kind).filter(Boolean))].sort();
+  const chip = (value, label) =>
+    `<button class="chip${value === lang ? " on" : ""}" data-lang="${esc(value)}">${esc(label)}</button>`;
+  box.innerHTML =
+    `<div class="supported">${CK_T("filter.supported")}${esc((data.languages || []).join("、"))}</div>` +
+    `<div class="chips">${chip("", CK_T("filter.all_langs"))}${langs.map((l) => chip(l, l)).join("")}</div>` +
+    `<label class="kindfilter">${CK_T("filter.kind")} <select id="kindsel"><option value="">${CK_T("filter.all")}</option>` +
+    kinds.map((k) => `<option value="${esc(k)}"${k === kind ? " selected" : ""}>${esc(k)}</option>`).join("") +
+    `</select></label>`;
+}
+
+function render() {
+  if (!data) return;
+  document.querySelectorAll("#tabs button").forEach((b) =>
+    b.setAttribute("aria-pressed", b.dataset.key === tab));
+  renderFilters();
+  const q = $("#search").value.toLowerCase();
+  const repo = $("#repo").value;
+  const match = (r) => JSON.stringify(r).toLowerCase().includes(q) &&
+    (!repo || r.repo === repo || (r.id && tab === "features")) &&
+    (tab !== "symbols" || ((!lang || r.lang === lang) && (!kind || r.kind === kind)));
+
+  const rows = (data[tab] || []).filter(match);
+  const suffix = tab === "symbols" ? CK_T("dev.filter_hint") : "";
+  $("#message").textContent = CK_T("dev.result", rows.length) + suffix;
+
+  let out = "";
+  if (tab === "repos") {
+    const deps = (data.lockedPackages || []).map((p) =>
+      `<code>${esc(p.identity)}</code><code>${esc((p.revision || "").slice(0, 12))}</code>`).join("");
+    out += '<article class="card"><h2>' + CK_T("dev.locked") + '</h2><div class="deps">' + (deps || "<code>（無）</code><code></code>") + "</div>" +
+      '<p class=muted>' + CK_T("dev.locked_note") + "</p></article>";
+  }
+  for (const r of rows.slice(0, 250)) {
+    if (tab === "features") {
+      /* 通用渲染：保留鍵以外的所有欄位逐列列出；標籤可用該筆的 labels 對照，預設用 key。 */
+      const reserved = new Set(["id", "name", "summary", "files", "docs", "labels"]);
+      const labels = r.labels || {};
+      const fields = Object.keys(r).filter((k) => !reserved.has(k))
+        .map((k) => [labels[k] || k, Array.isArray(r[k]) ? r[k].join("、") : r[k]])
+        .map(([k, v]) => `<dt>${esc(k)}</dt><dd>${esc(v)}</dd>`).join("");
+      out += `<article class="card"><h2>${esc(r.name)}</h2><div class="meta">${esc(r.id)}</div>` +
+        (r.summary ? `<p>${mdInline(r.summary)}</p>` : "") +
+        (fields ? `<dl>${fields}</dl>` : "") +
+        `<h3>${CK_T("dev.files")}</h3><div class="files">${links(r.files)}${links(r.docs)}</div></article>`;
+    } else if (tab === "symbols") {
+      out += `<article class="card"><h2><a href="${esc(r.url)}">${esc(r.name)}</a></h2>` +
+        `<div class="meta"><span class="kind">${esc(r.kind || kindOf(r.name))}</span>${esc(r.repo)} · ${esc(r.file)}:${r.line}</div>` +
+        (r.signature ? `<pre class="sig">${esc(r.signature)}</pre>` : "") +
+        `<div class="doc">${r.comment ? mdDoc(r.comment) : '<p class="muted">' + CK_T("dev.no_comment") + '</p>'}</div></article>`;
+    } else if (tab === "documents") {
+      out += `<article class="card"><h2><a href="${esc(r.url)}">${esc(r.name)}</a></h2>` +
+        `<div class="meta">${esc(r.repo)}</div><div class="preview">${esc(r.text.slice(0, 260))}${r.text.length > 260 ? " …" : ""}</div></article>`;
+    } else {
+      const list = (r.commits || []).map((c) => commitCard(r.name, c)).join("");
+      out += `<article class="card"><h2>${esc(r.name)}</h2><div class="meta">HEAD：${esc(r.head)}</div>` +
+        `<h3>${CK_T("dev.uncommitted")}</h3><pre class="blob">${esc(r.changes || CK_T("dev.clean"))}</pre>` +
+        `<div class="wt-wrap"><button class="wt-btn" type="button" data-repo="${esc(r.name)}">${CK_T("dev.worktree")}</button>` +
+        `<div class="diff" hidden></div></div>` +
+        `<h3>${CK_T("dev.commits20")}</h3><div class="commits">${list}</div></article>`;
+    }
+  }
+  if (rows.length > 250) out += '<p class="muted">' + CK_T("dev.more") + "</p>";
+  $("#results").innerHTML = out || '<p class="empty">' + CK_T("dev.no_data") + "</p>";
+}
+
+async function load() {
+  $("#message").textContent = CK_T("dev.loading");
+  diffCache.clear();
+  try {
+    const response = await fetch("/development/data");
+    const result = await response.json();
+    if (!response.ok) throw Error(result.error);
+    data = result;
+    const repos = [...new Set((data.symbols.concat(data.documents)).map((r) => r.repo))].sort();
+    const sel = $("#repo");
+    sel.innerHTML = '<option value="">' + CK_T("dev.repo_all") + '</option>' +
+      repos.map((r) => `<option value="${esc(r)}">${esc(r)}</option>`).join("");
+    render();
+  } catch (e) {
+    $("#message").textContent = CK_T("dev.load_failed") + e.message;
+  }
+}
+
+for (const [key, title] of Object.entries(LABELS)) {
+  const b = document.createElement("button");
+  b.textContent = CK_T(title); b.dataset.key = key;
+  b.onclick = () => { tab = key; render(); };
+  $("#tabs").append(b);
+}
+$("#search").oninput = render;
+$("#repo").onchange = render;
+$("#reload").onclick = load;
+
+$("#filters").addEventListener("click", (e) => {
+  const chip = e.target.closest(".chip");
+  if (chip) { lang = chip.dataset.lang; render(); }
+});
+$("#filters").addEventListener("change", (e) => {
+  if (e.target.id === "kindsel") { kind = e.target.value; render(); }
+});
+
+/* 事件委派：提交標題、檔名、工作區差異鈕（#results 每次 render 會重建）。 */
+$("#results").addEventListener("click", (e) => {
+  const file = e.target.closest("a.cfile");
+  if (file) {
+    e.preventDefault();
+    loadDiff(file.closest(".commit").querySelector(".diff"),
+      new URLSearchParams({ repo: file.dataset.repo, hash: file.dataset.hash, path: file.dataset.path }));
+    return;
+  }
+  const head = e.target.closest(".commit-head");
+  if (head) {
+    const box = head.parentElement.querySelector(".diff");
+    if (!box.hidden && box.innerHTML) { box.hidden = true; return; }
+    loadDiff(box, new URLSearchParams({ repo: head.parentElement.dataset.repo, hash: head.parentElement.dataset.hash }));
+    return;
+  }
+  const wt = e.target.closest(".wt-btn");
+  if (wt) loadDiff(wt.parentElement.querySelector(".diff"), new URLSearchParams({ repo: wt.dataset.repo, worktree: "1" }));
+});
+
+load();

changelogkit/assets/file.css

@@ -0,0 +1,51 @@
+/* 檔案檢視頁：行號、行跳轉、目標行高亮與語法上色。主題與共用元件在 theme.css。 */
+.appbar .spacer { flex: 1 }
+.appbar #jump { width: 92px }
+.wrap { height: calc(100vh - 53px); overflow: auto }
+#src {
+  margin: 0; padding: 6px 0 40px;
+  font: 13px/1.55 ui-monospace, Consolas, "Courier New", monospace;
+  white-space: pre; min-width: max-content;
+}
+#src .ln { display: block; padding: 0 16px 0 0 }
+#src .ln:hover { background: var(--line2) }
+#src .ln:target, #src .ln.hit { background: rgba(245, 158, 11, .24) }
+#src .no {
+  color: var(--mut); text-decoration: none; display: inline-block;
+  width: 4.6em; text-align: right; margin-right: 14px; user-select: none;
+}
+#src .no:hover { color: var(--accent) }
+
+@media (max-width: 640px) { .appbar #name { max-width: 40vw; overflow: hidden; text-overflow: ellipsis; white-space: nowrap } }
+
+/* Markdown 排版檢視 */
+.wrap > [hidden] { display: none }
+.rendered { max-width: 920px; margin: 0 auto; padding: 22px 22px 64px; line-height: 1.75 }
+.rendered h1, .rendered h2, .rendered h3, .rendered h4 { line-height: 1.3; margin: 1.4em 0 .5em }
+.rendered h1 { font-size: 1.7em; border-bottom: 1px solid var(--line); padding-bottom: .3em }
+.rendered h2 { font-size: 1.35em; border-bottom: 1px solid var(--line); padding-bottom: .25em }
+.rendered h3 { font-size: 1.15em }
+.rendered p, .rendered ul, .rendered ol, .rendered table, .rendered pre, .rendered blockquote, .rendered .alert { margin: .7em 0 }
+.rendered ul, .rendered ol { padding-left: 1.6em }
+.rendered li { margin: .2em 0 }
+.rendered img { max-width: 100%; border-radius: 8px }
+.rendered hr { border: 0; border-top: 1px solid var(--line); margin: 1.4em 0 }
+.rendered table { border-collapse: collapse; width: 100%; display: block; overflow-x: auto }
+.rendered th, .rendered td { border: 1px solid var(--line); padding: 6px 10px; text-align: left }
+.rendered th { background: var(--code) }
+.rendered blockquote { border-left: 3px solid var(--line); margin-left: 0; padding: .2em 0 .2em 1em; color: var(--mut) }
+
+/* GitHub 提示框（> [!NOTE] 等） */
+.rendered .alert { border: 1px solid var(--line); border-left-width: 4px; border-radius: 8px; padding: 10px 14px }
+.rendered .alert-title { margin: 0 0 .3em; font-weight: 600; display: flex; align-items: center; gap: .4em }
+.rendered .alert p:last-child { margin-bottom: 0 }
+.alert-note { border-left-color: #3b82f6; background: rgba(59, 130, 246, .10) }
+.alert-tip { border-left-color: #10b981; background: rgba(16, 185, 129, .10) }
+.alert-important { border-left-color: #8b5cf6; background: rgba(139, 92, 246, .10) }
+.alert-warning { border-left-color: #f59e0b; background: rgba(245, 158, 11, .12) }
+.alert-caution { border-left-color: #ef4444; background: rgba(239, 68, 68, .10) }
+.alert-note .alert-title { color: #3b82f6 }
+.alert-tip .alert-title { color: #10b981 }
+.alert-important .alert-title { color: #8b5cf6 }
+.alert-warning .alert-title { color: #f59e0b }
+.alert-caution .alert-title { color: #ef4444 }

changelogkit/assets/file.html

@@ -0,0 +1,29 @@
+<!doctype html>
+<html lang="{{lang_html}}"><head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+<title>{{title}} — {{t.dev.title}}</title>
+<script src="/assets/theme.js"></script>
+<script src="/assets/i18n.js"></script>
+<script>window.CK_I18N = {{i18n_json}};</script>
+<link rel="stylesheet" href="/assets/theme.css">
+<link rel="stylesheet" href="/assets/file.css">
+</head><body>
+<header class="appbar">
+  <a href="/development" id="back">{{t.file.back}}</a>
+  <strong id="name">{{title}}</strong>
+  <span class="muted">{{repo}}</span>
+  <span class="spacer"></span>
+  <button id="mode" hidden>{{t.file.source}}</button>
+  <input id="jump" type="number" min="1" placeholder="{{t.file.jump}}" aria-label="{{t.file.jump}}">
+  <button id="copy" title="{{t.file.copy}}">{{t.file.copy}}</button>
+  <button id="theme" aria-label="{{t.btn.theme}}" title="{{t.btn.theme}}">🌙</button>
+</header>
+<div class="wrap">
+  <pre id="src" data-repo="{{repo}}" data-path="{{path}}" data-line="{{line}}">{{content}}</pre>
+  <article id="rendered" class="rendered" hidden></article>
+</div>
+<script src="/assets/highlight.js"></script>
+<script src="/assets/markdown.js"></script>
+<script src="/assets/file.js"></script>
+</body></html>

changelogkit/assets/file.js

@@ -0,0 +1,101 @@
+/* 檔案檢視：行號、行跳轉、目標行高亮；Swift 上色；Markdown 預設排版檢視（可切回原始碼）。 */
+(function () {
+  const src = document.getElementById("src");
+  if (!src) return;
+  const rendered = document.getElementById("rendered");
+  const modeBtn = document.getElementById("mode");
+  const jump = document.getElementById("jump");
+  const isMarkdown = /\.(md|markdown)$/i.test(src.dataset.path || "");
+
+  // 1) 原始碼逐行上色（Markdown 也用於「原始碼」模式）。
+  const state = { block: false };
+  src.querySelectorAll(".code").forEach((el) => {
+    el.innerHTML = isMarkdown ? HL.markdownLine(el.textContent) : HL.swift(el.textContent, state);
+  });
+
+  const lines = src.querySelectorAll(".ln");
+  const total = lines.length;
+  const initial = parseInt(src.dataset.line || "0", 10);
+
+  function highlight(line) {
+    if (!(line >= 1 && line <= total)) return;
+    src.querySelectorAll(".ln.hit").forEach((el) => el.classList.remove("hit"));
+    const el = document.getElementById("L" + line);
+    if (el) { el.classList.add("hit"); el.scrollIntoView({ block: "center" }); }
+  }
+  function fromHash() {
+    const m = (location.hash || "").match(/^#L(\d+)$/);
+    return m ? parseInt(m[1], 10) : initial;
+  }
+  function go(line, push) {
+    if (!(line >= 1 && line <= total)) return;
+    if (push) history.replaceState(null, "", "#L" + line);
+    highlight(line);
+  }
+
+  src.addEventListener("click", (e) => {
+    const a = e.target.closest ? e.target.closest("a.no") : null;
+    const href = a && a.getAttribute("href");
+    if (href && href.indexOf("#L") === 0) { e.preventDefault(); go(parseInt(href.slice(2), 10), true); }
+  });
+
+  if (jump) {
+    jump.max = total;
+    jump.addEventListener("keydown", (e) => {
+      if (e.key === "Enter") { e.preventDefault(); go(parseInt(jump.value, 10), true); }
+    });
+  }
+
+  document.getElementById("copy")?.addEventListener("click", async (e) => {
+    const path = src.dataset.path || "";
+    try { await navigator.clipboard.writeText(path); e.currentTarget.textContent = CK_T("file.copied"); }
+    catch { e.currentTarget.textContent = path; }
+    setTimeout(() => { e.currentTarget.textContent = CK_T("file.copy"); }, 1500);
+  });
+
+  document.getElementById("back")?.addEventListener("click", (e) => {
+    if (history.length > 1) { e.preventDefault(); history.back(); }
+  });
+
+  window.addEventListener("hashchange", () => { if (!src.hidden) highlight(fromHash()); });
+
+  // 2) Markdown：排版檢視（預設）＋可切回原始碼。
+  function resolveHref(href) {
+    if (/^[a-z][a-z0-9+.-]*:/i.test(href) || href.startsWith("#") || href.startsWith("/")) return href;
+    const repo = src.dataset.repo || "app";
+    const [clean, ...rest] = href.split("#");
+    const base = (src.dataset.path || "").split("/").slice(0, -1);
+    for (const seg of clean.split("/")) {
+      if (seg === "" || seg === ".") continue;
+      if (seg === "..") { base.pop(); continue; }
+      base.push(seg);
+    }
+    const anchor = rest.length ? "#" + rest.join("#") : "";
+    return "/development/file?" + new URLSearchParams({ repo, path: base.join("/") }).toString() + anchor;
+  }
+
+  function setMode(mode) {
+    const renderedMode = mode === "rendered";
+    src.hidden = renderedMode;
+    if (rendered) rendered.hidden = !renderedMode;
+    if (jump) jump.hidden = renderedMode;
+    if (modeBtn) modeBtn.textContent = renderedMode ? CK_T("file.source") : CK_T("file.rendered");
+  }
+
+  if (isMarkdown && rendered && modeBtn) {
+    const raw = Array.from(src.querySelectorAll(".code")).map((el) => el.textContent).join("\n");
+    rendered.innerHTML = window.renderMarkdown(raw, resolveHref);
+    // 文件內的 #L 行號連結：切回原始碼模式再跳行（就地，不重載）。
+    rendered.addEventListener("click", (e) => {
+      const a = e.target.closest ? e.target.closest("a") : null;
+      const href = a && a.getAttribute("href");
+      if (href && href.startsWith("#L")) { e.preventDefault(); setMode("source"); go(parseInt(href.slice(2), 10), true); }
+    });
+    modeBtn.hidden = false;
+    let mode = "rendered";
+    setMode(mode);
+    modeBtn.addEventListener("click", () => { mode = mode === "rendered" ? "source" : "rendered"; setMode(mode); });
+  } else {
+    highlight(fromHash());
+  }
+})();