chore: import upstream snapshot with attribution

.help/scripts/split_topic_docs.py

@@ -0,0 +1,67 @@
+#!/usr/bin/env python3
+"""
+split_topic_docs.py — one-time migration: move each ui: topic's doc body out of the single
+ui-topics.md registry into its own file under references/topics/ui/<Id>.md, and reduce
+ui-topics.md to metadata only (heading + id/synonyms/parent/classes).
+
+After this, the per-topic .md is the single hand-edited source of the doc body; ui-topics.md keeps
+just the metadata, and analysis_to_index.py records a `docFile` pointer in topics.json that the
+editor loads lazily. Run once; safe to re-run (idempotent — a metadata-only ui-topics.md yields no
+bodies to move).
+"""
+
+import re
+from pathlib import Path
+
+HERE = Path(__file__).resolve().parent
+HELP = HERE.parent
+MD = HELP / "references" / "topics" / "ui-topics.md"
+OUTDIR = HELP / "references" / "topics" / "ui"
+
+
+def main():
+    OUTDIR.mkdir(parents=True, exist_ok=True)
+    lines = MD.read_text(encoding="utf-8").replace("\r\n", "\n").split("\n")
+
+    out = []
+    i = 0
+    while i < len(lines) and not lines[i].startswith("## "):   # preamble
+        out.append(lines[i])
+        i += 1
+
+    written = 0
+    while i < len(lines):
+        header = lines[i]
+        i += 1
+        meta = []
+        while i < len(lines) and lines[i].strip() != "" and not lines[i].startswith("## "):
+            meta.append(lines[i])
+            i += 1
+        while i < len(lines) and lines[i].strip() == "":
+            i += 1
+        body = []
+        while i < len(lines) and not lines[i].startswith("## "):
+            body.append(lines[i])
+            i += 1
+
+        topic_id = None
+        for m in meta:
+            mm = re.match(r"id:\s*(\S+)\s*$", m)
+            if mm:
+                topic_id = mm.group(1)
+
+        body_text = "\n".join(body).strip()
+        if topic_id and body_text and not body_text.lower().startswith("_todo"):
+            (OUTDIR / f"{topic_id}.md").write_text(body_text + "\n", encoding="utf-8", newline="\n")
+            written += 1
+
+        out.append(header)
+        out.extend(meta)
+        out.append("")   # blank line closes the metadata block
+
+    MD.write_text("\n".join(out).rstrip("\n") + "\n", encoding="utf-8", newline="\n")
+    print(f"wrote {written} topic doc file(s) to {OUTDIR.relative_to(HELP)}; ui-topics.md is now metadata-only")
+
+
+if __name__ == "__main__":
+    main()