@kanf/wema-kake 0.0.0-stage → 0.1.1

package/dist/lib/shared/guide.js

@@ -0,0 +1,259 @@
+/** 最初のページのスラッグ */
+export const FIRST_PAGE_SLUG = 'first-page';
+const paragraphs = (heading, lines) => `<b>${heading}</b>${lines.map((line) => `<div>${line}</div>`).join('')}`;
+/** 装飾の見本。HTML は、wema が画面の操作で作るものと同じ形にする */
+const sample = (text) => `<b>${text.heading}</b>` +
+    `<div><b>${text.bold}</b>${text.separator}<s>${text.strike}</s>${text.separator}` +
+    `<span style="color: #d32f2f">${text.color}</span>${text.separator}` +
+    `<a href="https://github.com/kan/wema-kake" target="_blank" rel="noopener">${text.link}</a></div>` +
+    `<ul><li>${text.bullet}<ul><li>${text.nested}</li></ul></li></ul>` +
+    `<ol><li>${text.numbered[0]}</li><li>${text.numbered[1]}</li></ol>` +
+    '<ul class="wema-checklist">' +
+    `<li><input type="checkbox">${text.todo}</li>` +
+    `<li class="wema-checked"><input type="checkbox" checked>${text.done}</li>` +
+    '</ul>';
+const TEXTS = {
+    ja: {
+        firstPageTitle: '最初のページ',
+        intro: {
+            first: paragraphs('wema-kake へようこそ', [
+                '付箋を並べて書く Wiki です。',
+                '1 ページが、1 枚のボードになります。',
+                'このページの付箋は、消してかまいません。',
+            ]),
+            help: paragraphs('使い方', [
+                '試すためのボードです。',
+                '付箋を動かしたり、書き換えたりできます。',
+                'ここでの変更は、保存されません。',
+            ]),
+        },
+        sample: sample({
+            heading: '装飾の見本',
+            bold: '太字',
+            strike: '取り消し線',
+            color: '文字の色',
+            link: 'リンク',
+            separator: '、',
+            bullet: '箇条書き',
+            nested: '段を下げた項目',
+            numbered: ['番号付きのリスト', '2 つ目'],
+            todo: 'チェックリスト',
+            done: '済んだ項目',
+        }),
+        sections: {
+            notes: [
+                '付箋',
+                [
+                    '空いている場所をダブルクリック → 作る',
+                    '上端をドラッグ → 動かす',
+                    '右下をドラッグ → 大きさを変える',
+                    '右下をダブルクリック → 内容に合わせる',
+                    '選択して Delete → 削除する',
+                    'Shift + クリック → 複数を選ぶ',
+                    'Ctrl + ドラッグ → 囲んで選ぶ',
+                ],
+            ],
+            text: [
+                '本文',
+                [
+                    '文字を選択 → 太字、取り消し線、色、リンク',
+                    '付箋を選択 → 色、リスト、画像',
+                    'リストの中で Tab → 段を下げる',
+                    '長い本文は、畳んで表示できる',
+                ],
+            ],
+            edges: [
+                '接続線',
+                [
+                    '縁の ● をドラッグ → 他の付箋とつなぐ',
+                    '空いている場所で離す → 先に付箋を作る',
+                    '線をクリック → 種類やラベルを変える',
+                ],
+            ],
+            view: [
+                '表示',
+                [
+                    'ホイール、空いた場所をドラッグ → 動かす',
+                    'Ctrl + ホイール、ピンチ → 拡大と縮小',
+                    'Ctrl + Z → 元に戻す（自分の操作だけ）',
+                    'メニューの「参照モード」 → 読むだけにする',
+                    '狭い画面では、縦 1 列に並べて表示する',
+                    '並んでいる間は動かせず、線は印になる',
+                ],
+            ],
+            pages: [
+                'ページ',
+                [
+                    '「子ページを置く」 → 中にページを作る',
+                    '子ページの表示名をクリック → 中へ入る',
+                    '付箋を子ページへドラッグ → 中へ移動（Ctrl でコピー）',
+                    '/p/ページ名 へのリンク → 他のページへ移る',
+                    '左上の表示名をクリック → 名前を変える',
+                ],
+            ],
+            llm: [
+                'LLM',
+                [
+                    'MCP でつなぐと、Claude などが読み書きできる',
+                    'LLM の操作は、メニューの「操作の履歴」に残る',
+                    '履歴から、操作ごとに取り消せる',
+                ],
+            ],
+        },
+        column: 460,
+    },
+    en: {
+        firstPageTitle: 'First page',
+        intro: {
+            first: paragraphs('Welcome to wema-kake', [
+                'A wiki you write with sticky notes.',
+                'Each page is one board.',
+                'Feel free to delete the notes on this page.',
+            ]),
+            help: paragraphs('Help', [
+                'A board for trying things out.',
+                'Move the notes around or rewrite them.',
+                'Nothing you change here is saved.',
+            ]),
+        },
+        sample: sample({
+            heading: 'Formatting sample',
+            bold: 'Bold',
+            strike: 'strikethrough',
+            color: 'text color',
+            link: 'link',
+            separator: ', ',
+            bullet: 'Bulleted list',
+            nested: 'Indented item',
+            numbered: ['Numbered list', 'Second item'],
+            todo: 'Checklist',
+            done: 'Finished item',
+        }),
+        sections: {
+            notes: [
+                'Notes',
+                [
+                    'Double-click an empty spot → create',
+                    'Drag the top edge → move',
+                    'Drag the bottom-right corner → resize',
+                    'Double-click that corner → fit the content',
+                    'Select and press Delete → delete',
+                    'Shift + click → select several',
+                    'Ctrl + drag → select an area',
+                ],
+            ],
+            text: [
+                'Text',
+                [
+                    'Select text → bold, strikethrough, color, link',
+                    'Select a note → color, lists, image',
+                    'Tab inside a list → indent',
+                    'A long text can be shown folded',
+                ],
+            ],
+            edges: [
+                'Connections',
+                [
+                    'Drag a ● on the edge → connect to a note',
+                    'Drop on an empty spot → create a note there',
+                    'Click a line → change its style or label',
+                ],
+            ],
+            view: [
+                'View',
+                [
+                    'Wheel, or drag an empty spot → pan',
+                    'Ctrl + wheel, or pinch → zoom',
+                    'Ctrl + Z → undo (your own changes only)',
+                    '“View-only mode” in the menu → read only',
+                    'A narrow screen shows the notes in one column',
+                    'There, notes do not move; lines become chips',
+                ],
+            ],
+            pages: [
+                'Pages',
+                [
+                    '“Place a child page” → a page inside this one',
+                    'Click a child page’s title → go inside',
+                    'Drag a note onto a child page → move it inside (Ctrl: copy)',
+                    'A link to /p/page-name → go to that page',
+                    'Click the title at the top left → rename',
+                ],
+            ],
+            llm: [
+                'LLM',
+                [
+                    'Over MCP, Claude and others can read and write',
+                    'Their operations are kept in “Operation history”',
+                    'Revert them there, one operation at a time',
+                ],
+            ],
+        },
+        column: 480,
+    },
+};
+/** 最初のページの表示名 */
+export const firstPageTitle = (lang) => TEXTS[lang].firstPageTitle;
+/** 段の位置 */
+const ROWS = [60, 370, 680];
+/**
+ * 付箋の色、位置（列、段）、高さの目安。autoSize にするので、実際の大きさは、ボードが読み込んだ
+ * ときに wema が計測して決める（wema 0.10.0 以降）。高さは、計測されるまでの値
+ */
+const LAYOUT = {
+    sample: { color: '#F5F5F5', column: 0, row: 0, height: 250 },
+    intro: { color: '#FFF9C4', column: 1, row: 0, height: 120 },
+    notes: { color: '#BBDEFB', column: 0, row: 1, height: 220 },
+    text: { color: '#FFE0B2', column: 1, row: 1, height: 170 },
+    edges: { color: '#C8E6C9', column: 2, row: 1, height: 150 },
+    view: { color: '#FFCDD2', column: 0, row: 2, height: 210 },
+    pages: { color: '#E1BEE7', column: 1, row: 2, height: 170 },
+    llm: { color: '#B2DFDB', column: 2, row: 2, height: 150 },
+};
+/** 接続線。案内の付箋から 2 段目へ、2 段目から 3 段目へ。装飾の見本は、どれともつながない */
+const EDGES = [
+    ['intro', 'notes'],
+    ['intro', 'text'],
+    ['intro', 'edges'],
+    ['notes', 'view'],
+    ['text', 'pages'],
+    ['edges', 'llm'],
+];
+const noteId = (key) => `guide-${key}`;
+/** 案内の付箋の id。付箋を縦に積む画面で、先頭に並べるのに使う（src/web/stacked-view.ts） */
+export const GUIDE_INTRO_ID = noteId('intro');
+/** 使い方の付箋と接続線。`intro` で、案内の付箋の文面を選ぶ */
+export function guideBoard(intro, lang) {
+    const text = TEXTS[lang];
+    const bodyOf = (key) => {
+        if (key === 'sample')
+            return text.sample;
+        if (key === 'intro')
+            return text.intro[intro];
+        const [heading, items] = text.sections[key];
+        return `<b>${heading}</b><ul>${items.map((item) => `<li>${item}</li>`).join('')}</ul>`;
+    };
+    const notes = Object.keys(LAYOUT).map((key, index) => {
+        const { color, column, row, height } = LAYOUT[key];
+        return {
+            id: noteId(key),
+            x: 60 + column * text.column,
+            y: ROWS[row],
+            width: 380,
+            height,
+            text: bodyOf(key),
+            color,
+            zIndex: index + 1,
+            autoSize: true,
+        };
+    });
+    const edges = EDGES.map(([from, to]) => ({
+        id: `guide-${from}-${to}`,
+        from: noteId(from),
+        to: noteId(to),
+        fromAnchor: 'auto',
+        toAnchor: 'auto',
+        style: 'arrow',
+    }));
+    return { notes, edges };
+}

package/dist/lib/shared/hierarchy.d.ts

@@ -0,0 +1,31 @@
+import type { HistoryDelta, WemaNote } from './delta';
+/** 子ページの付箋の meta のキー。値は、子ページのスラッグ */
+export declare const CHILD_PAGE_KEY = "page";
+/** 階層の深さの上限。ルートを 1 段目と数える */
+export declare const MAX_DEPTH = 5;
+/**
+ * 子ページとして置けなかった理由。
+ * - not-found: ページがない
+ * - self: 自分自身を置こうとした
+ * - other-parent: すでに別のページの子になっている
+ * - duplicate: このページに、すでに置いてある
+ * - ancestor: このページの先祖なので、輪になる
+ * - too-deep: 深さの上限を超える
+ */
+export type ChildRejectCode = 'not-found' | 'self' | 'other-parent' | 'duplicate' | 'ancestor' | 'too-deep';
+/** 置けなかったことを表す `reason`。画面は `parseChildRejection` で読み、agent はそのまま読む */
+export declare function childRejection(code: ChildRejectCode, page: string): string;
+/** `reason` が、子ページとして置けなかったことを表していれば、理由とページを返す */
+export declare function parseChildRejection(reason: string): {
+    code: ChildRejectCode;
+    page: string;
+} | undefined;
+/** 子ページの付箋なら、子ページのスラッグを返す */
+export declare function childPageOf(note: Pick<WemaNote, 'meta'>): string | undefined;
+/**
+ * デルタが、子ページの付箋の集合を変え得るか。変え得るのは、付箋の削除（消す付箋が子ページの
+ * 付箋かどうかは、保存してある値で決まる）、子ページの付箋の作成、meta の更新
+ */
+export declare function touchesChildren(deltas: HistoryDelta[]): boolean;
+/** デルタを適用すると、新しく子として置かれることになるページ（重複は除く） */
+export declare function placedPages(deltas: HistoryDelta[]): string[];

package/dist/lib/shared/hierarchy.js

@@ -0,0 +1,40 @@
+/** 子ページの付箋の meta のキー。値は、子ページのスラッグ */
+export const CHILD_PAGE_KEY = 'page';
+/** 階層の深さの上限。ルートを 1 段目と数える */
+export const MAX_DEPTH = 5;
+/** 置けなかったときの `reject` の `reason` の先頭。続けて、理由と、置こうとしたページが入る */
+const REJECT_PREFIX = 'child page: ';
+/** 置けなかったことを表す `reason`。画面は `parseChildRejection` で読み、agent はそのまま読む */
+export function childRejection(code, page) {
+    return `${REJECT_PREFIX}${code}: ${page}`;
+}
+/** `reason` が、子ページとして置けなかったことを表していれば、理由とページを返す */
+export function parseChildRejection(reason) {
+    if (!reason.startsWith(REJECT_PREFIX))
+        return undefined;
+    const [code, page] = reason.slice(REJECT_PREFIX.length).split(': ');
+    return { code: code, page: page ?? '' };
+}
+/** 子ページの付箋なら、子ページのスラッグを返す */
+export function childPageOf(note) {
+    return note.meta?.[CHILD_PAGE_KEY];
+}
+/**
+ * デルタが、子ページの付箋の集合を変え得るか。変え得るのは、付箋の削除（消す付箋が子ページの
+ * 付箋かどうかは、保存してある値で決まる）、子ページの付箋の作成、meta の更新
+ */
+export function touchesChildren(deltas) {
+    return deltas.some((d) => d.type === 'note:delete' ||
+        (d.type === 'note:create' && childPageOf(d.note) !== undefined) ||
+        (d.type === 'note:update' && ('meta' in d.before || 'meta' in d.after)));
+}
+/** デルタを適用すると、新しく子として置かれることになるページ（重複は除く） */
+export function placedPages(deltas) {
+    const pages = new Set();
+    for (const d of deltas) {
+        const page = d.type === 'note:create' ? childPageOf(d.note) : d.type === 'note:update' ? childPageOf(d.after) : undefined;
+        if (page !== undefined)
+            pages.add(page);
+    }
+    return [...pages];
+}

package/dist/lib/shared/i18n.d.ts

@@ -0,0 +1,23 @@
+export type Lang = 'ja' | 'en';
+export declare const LANGS: readonly Lang[];
+/** サイトの設定で既定の言語を省いたときの言語 */
+export declare const DEFAULT_LANG: Lang;
+/**
+ * 選んだ言語を持つ Cookie の名前。値は Lang。選んでいない端末には置かない。
+ * 画面のスクリプトが読み書きする（秘密の値ではない）。サーバーは読むだけ
+ */
+export declare const LANG_COOKIE = "wk_lang";
+export declare const isLang: (value: string | undefined) => value is Lang;
+/**
+ * 言語を決める。`chosen` は、選んだ言語（Cookie の値。なければ undefined）。`preferred` は、
+ * ブラウザの言語の並び（優先の高い順。`ja-JP` のような地域つきの値は、先頭の部分で比べる）。
+ * `fallback` は、どちらにも当たらないときの言語（サイトの既定の言語）。省けないようにしてあるのは、
+ * 渡し忘れて設定の `defaultLang` が黙って無視されるのを、型で防ぐため
+ */
+export declare function resolveLang(chosen: string | undefined, preferred: readonly string[], fallback: Lang): Lang;
+/** Cookie の文字列（`document.cookie` か、Cookie ヘッダー）から、`name` の値を取り出す */
+export declare function cookieValue(cookies: string | null | undefined, name: string): string | undefined;
+/** Accept-Language の値を、優先の高い順の言語の並びにする。q が 0 のものは外す */
+export declare function parseAcceptLanguage(header: string | null | undefined): string[];
+/** リクエストを送ってきたブラウザの、画面の言語。`fallback` はサイトの既定の言語 */
+export declare function requestLang(request: Request, fallback: Lang): Lang;

package/dist/lib/shared/i18n.js

@@ -0,0 +1,58 @@
+// 画面の言語を決める処理。画面とサーバーの両方が使う（docs/plan.md のフェーズ 9）。
+//
+// 言語は、次の順で決める。
+//   1. その端末で選んだ言語（Cookie）
+//   2. ブラウザの言語の設定（サーバーでは Accept-Language、画面では navigator.languages）
+//   3. どちらにも対応する言語がなければ、サイトの既定の言語（設定の `defaultLang`。省けば DEFAULT_LANG）
+export const LANGS = ['ja', 'en'];
+/** サイトの設定で既定の言語を省いたときの言語 */
+export const DEFAULT_LANG = 'en';
+/**
+ * 選んだ言語を持つ Cookie の名前。値は Lang。選んでいない端末には置かない。
+ * 画面のスクリプトが読み書きする（秘密の値ではない）。サーバーは読むだけ
+ */
+export const LANG_COOKIE = 'wk_lang';
+export const isLang = (value) => LANGS.includes(value);
+/**
+ * 言語を決める。`chosen` は、選んだ言語（Cookie の値。なければ undefined）。`preferred` は、
+ * ブラウザの言語の並び（優先の高い順。`ja-JP` のような地域つきの値は、先頭の部分で比べる）。
+ * `fallback` は、どちらにも当たらないときの言語（サイトの既定の言語）。省けないようにしてあるのは、
+ * 渡し忘れて設定の `defaultLang` が黙って無視されるのを、型で防ぐため
+ */
+export function resolveLang(chosen, preferred, fallback) {
+    if (isLang(chosen))
+        return chosen;
+    for (const tag of preferred) {
+        const primary = tag.trim().toLowerCase().split('-')[0];
+        if (isLang(primary))
+            return primary;
+    }
+    return fallback;
+}
+/** Cookie の文字列（`document.cookie` か、Cookie ヘッダー）から、`name` の値を取り出す */
+export function cookieValue(cookies, name) {
+    for (const part of (cookies ?? '').split(';')) {
+        const eq = part.indexOf('=');
+        if (eq !== -1 && part.slice(0, eq).trim() === name)
+            return part.slice(eq + 1).trim();
+    }
+    return undefined;
+}
+/** Accept-Language の値を、優先の高い順の言語の並びにする。q が 0 のものは外す */
+export function parseAcceptLanguage(header) {
+    return (header ?? '')
+        .split(',')
+        .map((part, index) => {
+        const [tag, ...params] = part.split(';');
+        const q = params.map((param) => /^\s*q\s*=\s*([\d.]+)\s*$/.exec(param)?.[1]).find((value) => value !== undefined);
+        return { tag: tag.trim(), q: q === undefined ? 1 : Number(q), index };
+    })
+        .filter(({ tag, q }) => tag !== '' && tag !== '*' && q > 0)
+        // q が同じなら、書かれた順
+        .sort((a, b) => b.q - a.q || a.index - b.index)
+        .map(({ tag }) => tag);
+}
+/** リクエストを送ってきたブラウザの、画面の言語。`fallback` はサイトの既定の言語 */
+export function requestLang(request, fallback) {
+    return resolveLang(cookieValue(request.headers.get('Cookie'), LANG_COOKIE), parseAcceptLanguage(request.headers.get('Accept-Language')), fallback);
+}

package/dist/lib/shared/note-html.d.ts

@@ -0,0 +1,10 @@
+/** テキストにするときに、改行として扱うタグ */
+export declare const BLOCK_TAGS: readonly ['br', 'div', 'p', 'li', 'ul', 'ol', 'blockquote'];
+/**
+ * 文字参照を、文字に戻す。タグを外した後のテキストに使う（HTMLRewriter も、正規表現でタグを外した
+ * 結果も、文字参照は復号されないまま残る）。
+ *
+ * 名前付きの文字参照は、上の 6 つだけを戻す（ブラウザが付箋の HTML に書き出すもの）。` ` は、
+ * ふつうの空白にする。それ以外は、書かれたまま残す
+ */
+export declare function decodeEntities(s: string): string;

package/dist/lib/shared/note-html.js

@@ -0,0 +1,28 @@
+// 付箋の text（HTML）からテキストを取り出すときに使うもの（検索の索引、LLM へ渡すテキスト。
+// src/worker/plain-text.ts）。HTMLRewriter に頼らないので、ブラウザの側からも使える。
+/** テキストにするときに、改行として扱うタグ */
+export const BLOCK_TAGS = ['br', 'div', 'p', 'li', 'ul', 'ol', 'blockquote'];
+const NAMED_ENTITIES = {
+    amp: '&',
+    lt: '<',
+    gt: '>',
+    quot: '"',
+    apos: "'",
+    nbsp: ' ',
+};
+/**
+ * 文字参照を、文字に戻す。タグを外した後のテキストに使う（HTMLRewriter も、正規表現でタグを外した
+ * 結果も、文字参照は復号されないまま残る）。
+ *
+ * 名前付きの文字参照は、上の 6 つだけを戻す（ブラウザが付箋の HTML に書き出すもの）。`&nbsp;` は、
+ * ふつうの空白にする。それ以外は、書かれたまま残す
+ */
+export function decodeEntities(s) {
+    return s.replace(/&(#x[0-9a-f]+|#\d+|[a-z]+);/gi, (whole, entity) => {
+        if (entity[0] !== '#')
+            return NAMED_ENTITIES[entity.toLowerCase()] ?? whole;
+        const hex = entity[1] === 'x' || entity[1] === 'X';
+        const code = Number.parseInt(entity.slice(hex ? 2 : 1), hex ? 16 : 10);
+        return code > 0 && code <= 0x10ffff ? String.fromCodePoint(code) : whole;
+    });
+}

package/dist/lib/shared/note-info.d.ts

@@ -0,0 +1,20 @@
+import type { HistoryDelta } from './delta';
+export interface NoteInfo {
+    /** 作成者（'user:<email>' / 'agent:<client>'）。分からなければ null */
+    createdBy: string | null;
+    /** 最後に変更した時刻（UNIX ミリ秒）。移動や大きさの変更でも変わる */
+    updatedAt: number;
+}
+/** 付箋の id ごとの付加情報（スナップショットに載せる形） */
+export type NoteInfos = Record<string, NoteInfo>;
+/** 作成者が agent（MCP のクライアント）か */
+export declare const isAgentActor: (actor: string | null) => boolean;
+/**
+ * 確定した操作を、付加情報に反映する。サーバーが付箋の行に書く値（`created_by`、`updated_at`）と
+ * 同じ結果になる。変わった付箋の id を返す。
+ *
+ * @param actor 操作の主体
+ * @param at 操作を記録した時刻
+ * @param deltas サーバーが実際に適用したデルタ
+ */
+export declare function applyOpToInfos(infos: Map<string, NoteInfo>, actor: string, at: number, deltas: HistoryDelta[]): Set<string>;

package/dist/lib/shared/note-info.js

@@ -0,0 +1,29 @@
+/** 作成者が agent（MCP のクライアント）か */
+export const isAgentActor = (actor) => actor?.startsWith('agent:') ?? false;
+/**
+ * 確定した操作を、付加情報に反映する。サーバーが付箋の行に書く値（`created_by`、`updated_at`）と
+ * 同じ結果になる。変わった付箋の id を返す。
+ *
+ * @param actor 操作の主体
+ * @param at 操作を記録した時刻
+ * @param deltas サーバーが実際に適用したデルタ
+ */
+export function applyOpToInfos(infos, actor, at, deltas) {
+    const changed = new Set();
+    for (const d of deltas) {
+        if (d.type === 'note:create') {
+            infos.set(d.note.id, { createdBy: actor, updatedAt: at });
+            changed.add(d.note.id);
+        }
+        else if (d.type === 'note:delete') {
+            if (infos.delete(d.note.id))
+                changed.add(d.note.id);
+        }
+        else if (d.type === 'note:update') {
+            // 手元にない付箋の更新は、作成者が分からないまま、時刻だけを持つ
+            infos.set(d.noteId, { createdBy: infos.get(d.noteId)?.createdBy ?? null, updatedAt: at });
+            changed.add(d.noteId);
+        }
+    }
+    return changed;
+}

package/dist/lib/shared/note-text.d.ts

@@ -0,0 +1,11 @@
+/** ページへのリンクの書式 */
+export declare const pageLink: (slug: string) => string;
+/**
+ * URL に使える文字（正規表現の文字クラスの中身）。ASCII の、空白でない文字のうち、引用符、山かっこ、
+ * 角かっこ（`[[slug]]` と紛れる）、バックスラッシュ、波かっこなどを除いたもの。
+ * **引用符と山かっこを足さないこと**（リンクの `href` に、エスケープなしで入れている）
+ */
+export declare const URL_CHARS = "!#-&(-;=?-Z_a-z~";
+/** 文の側のものとして、URL の末尾から外す句読点 */
+export declare const TRAILING_PUNCTUATION = ".,;:!?";
+export declare function textToHtml(text: string): string;

package/dist/lib/shared/note-text.js

@@ -0,0 +1,118 @@
+// LLM（MCP / WebMCP）が渡すプレーンテキストを、付箋の text（HTML）にする。
+// 受け付ける書式は、箇条書き（`- `）、チェックリスト（`- [ ]` / `- [x]`）、ページへのリンク
+// （`[[slug]]`）だけ。それ以外はそのままの文字として扱う（HTML のタグを書いても、タグとしては
+// 解釈しない）。本文にそのまま書いた URL（http / https）は、URL を文字にしたリンクになる。
+//
+// 読むとき（read_board）は、src/worker/plain-text.ts が、ページへのリンクを同じ書式に戻す。
+import { SLUG_PATTERN } from './slug';
+/** 本文の中の、ページへのリンク。`[[` と `]]` の間は、スラッグそのもの */
+const PAGE_LINK_RE = new RegExp(`\\[\\[(${SLUG_PATTERN})\\]\\]`, 'g');
+/** ページへのリンクの書式 */
+export const pageLink = (slug) => `[[${slug}]]`;
+const escapeHtml = (text) => text.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+/**
+ * URL に使える文字（正規表現の文字クラスの中身）。ASCII の、空白でない文字のうち、引用符、山かっこ、
+ * 角かっこ（`[[slug]]` と紛れる）、バックスラッシュ、波かっこなどを除いたもの。
+ * **引用符と山かっこを足さないこと**（リンクの `href` に、エスケープなしで入れている）
+ */
+export const URL_CHARS = '!#-&(-;=?-Z_a-z~';
+/**
+ * 本文の中の URL の候補。URL に使える文字の並び（日本語の文に続けて書かれても、URL の終わりが分かる）
+ */
+const URL_RE = new RegExp(`https?://[${URL_CHARS}]+`, 'g');
+/** 全体が、URL に使える文字だけでできているか */
+const SAFE_URL_RE = new RegExp(`^[${URL_CHARS}]+$`);
+/** 文の側のものとして、URL の末尾から外す句読点 */
+export const TRAILING_PUNCTUATION = '.,;:!?';
+/**
+ * URL の候補から、後ろに続いていた文字（文の句読点や、閉じかっこ）を外して、URL にする。
+ * `length` は、候補のうち URL として使った長さ。リンクにできないものは null。
+ *
+ * **リンクの文字は、リンク先の URL そのものにする**（`href`）。文字とリンク先を別々に書ける
+ * 書式は作らない。LLM が、文字でリンク先を偽れないようにするため。
+ * - ユーザー名やパスワードを含む URL（`https://信頼できる名前@別のホスト/`）は、リンクにしない
+ * - 国際化ドメイン名は、解釈した後の形（Punycode）で出る。似た文字のホスト名を見分けられる
+ */
+function externalLink(candidate) {
+    let end = candidate.length;
+    // 余っている閉じかっこの数。最初に 1 回だけ数える（外すたびに数え直すと、かっこの並んだ本文で遅くなる）
+    let unmatched = candidate.split(')').length - candidate.split('(').length;
+    for (;; end--) {
+        const last = candidate[end - 1];
+        // 閉じかっこは、対になる開きかっこが URL の中にないときだけ、文の側のものとして外す
+        if (last === ')' && unmatched > 0)
+            unmatched--;
+        else if (!TRAILING_PUNCTUATION.includes(last))
+            break;
+    }
+    let url;
+    try {
+        url = new URL(candidate.slice(0, end));
+    }
+    catch {
+        return null;
+    }
+    if (url.username !== '' || url.password !== '')
+        return null;
+    // 解釈した後の URL に、使えない文字が現れたら、リンクにしない。ホスト名のパーセントエンコードは
+    // 復号されるので（`https://x%22y/` → `https://x"y/`）、引用符で `href` の外へ出られてしまう
+    if (!SAFE_URL_RE.test(url.href))
+        return null;
+    return { href: url.href, length: end };
+}
+/** URL を含まない文字を HTML にする。エスケープしてから、ページへのリンクをリンクに変える */
+const plainHtml = (text) => escapeHtml(text).replace(PAGE_LINK_RE, (_, slug) => `<a href="/p/${slug}">${slug}</a>`);
+/** 1 行ぶんの文字を HTML にする。URL と、ページへのリンクを、リンクに変える */
+function inlineHtml(text) {
+    let html = '';
+    let from = 0;
+    for (const match of text.matchAll(URL_RE)) {
+        const link = externalLink(match[0]);
+        if (!link)
+            continue;
+        const href = escapeHtml(link.href);
+        html += plainHtml(text.slice(from, match.index));
+        html += `<a href="${href}" target="_blank" rel="noopener noreferrer">${href}</a>`;
+        from = match.index + link.length;
+    }
+    return html + plainHtml(text.slice(from));
+}
+const CHECK_RE = /^- \[([ xX])\] ?(.*)$/;
+const BULLET_RE = /^- (.*)$/;
+function kindOf(line) {
+    if (CHECK_RE.test(line))
+        return 'check';
+    if (BULLET_RE.test(line))
+        return 'bullet';
+    return 'plain';
+}
+/** wema のチェックリストと同じ形の HTML にする */
+function checkItem(line) {
+    const [, mark, text] = CHECK_RE.exec(line);
+    const checked = mark !== ' ';
+    return (`<li${checked ? ' class="wema-checked"' : ''}>` +
+        `<input type="checkbox"${checked ? ' checked' : ''}>${inlineHtml(text)}</li>`);
+}
+export function textToHtml(text) {
+    const lines = text.replace(/\r\n?/g, '\n').split('\n');
+    const blocks = [];
+    for (let i = 0; i < lines.length;) {
+        const kind = kindOf(lines[i]);
+        let end = i;
+        while (end < lines.length && kindOf(lines[end]) === kind)
+            end++;
+        const group = lines.slice(i, end);
+        if (kind === 'check') {
+            blocks.push(`<ul class="wema-checklist">${group.map(checkItem).join('')}</ul>`);
+        }
+        else if (kind === 'bullet') {
+            const items = group.map((line) => `<li>${inlineHtml(BULLET_RE.exec(line)[1])}</li>`);
+            blocks.push(`<ul>${items.join('')}</ul>`);
+        }
+        else {
+            blocks.push(group.map(inlineHtml).join('<br>'));
+        }
+        i = end;
+    }
+    return blocks.join('');
+}