mossmd 0.8.1

package/CHANGELOG.md

@@ -0,0 +1,87 @@
+# Changelog
+
+## 未发布
+
+### 新增
+
+- 新增 `data-theme="blue"` 和 `data-theme="blue-light"` 蓝色主题 preset。
+- 蓝色主题覆盖编辑器与内容渲染共用的 `--moss-*` token，并同步调整链接、选区、搜索高亮、代码背景和语法高亮。
+- 新增水平分隔线对称图标语法，例如 `---⭐---` 和 `***🌿***`。
+
+### 调整
+
+- 无序列表预览态 marker 改为按嵌套层级轮换 `✦` / `✧`。
+- 移除 `inlinePreviewConfig.horizontalRule.glyph`，水平分隔线图标改由 Markdown 原文语法表达。
+
+### 修复
+
+- 修复表格单元格内 `==highlight==` 点击后未显露源码分隔符的问题。
+
+### 文档
+
+- README 增加蓝色主题 preset 的使用示例。
+- Demo 将配色切换与明暗切换拆成两个独立按钮，可组合预览默认/蓝色与深色/浅色。
+- 默认 `---`、`***`、`___` 不再自动附加图标，图标由 Markdown 原文显式提供。
+
+## 0.8.1 - 2026-09-22
+
+### 新增
+
+- 水平分隔线内置支持三种视觉样式：`---` 普通实线、`***` 舒缓波浪线、`___` 中间带符号的分隔线。
+- 新增 `inlinePreviewConfig.horizontalRule.glyph`，支持自定义文本或 emoji 作为分隔线中间符号。
+
+### 调整
+
+- 将 HR 的波浪线和符号渲染从 Demo 私有实现收回编辑器核心样式。
+- 删除 Demo 中独立的 `wavy-hr.ts` 自定义语法示例，避免消费者为内置 HR 样式额外注册扩展。
+- Demo 使用 `🌿` 演示自定义 HR 符号。
+
+### 修复
+
+- 放宽波浪线重复周期，降低视觉密集和尖锐感。
+
+## 0.8.0 - 2026-09-22
+
+### 新增
+
+- 新增顶层 `MossMDProps.icons` 配置，统一覆盖图片块、文件块和上传进度块的用户可见图标。
+- 新增 `mossmd/icons` 子路径，导出 `MossIconRenderer`、`mossLucideIcon`、`renderLucideIcon` 和 `renderMossIcon`。
+- 新增图片块、文件块、上传块的图标配置类型，并允许 Slash Command 直接使用自定义 `MossIconRenderer`。
+- Demo 正文新增自定义图标代码示例。
+
+### 调整
+
+- 图标渲染从 `lucideSvg` 字符串方案切换为 DOM renderer 协议，不再依赖 `react-dom/server`。
+- `MossMDProps.icons` 作为 React 入口的推荐配置方式，保留 feature 级 `imagesConfig.icons`、`fileBlocksConfig.icons`、`fileUpload.icons` 作为更细粒度覆盖。
+- `mossFileUpload(config)` 复用 `mossUploadBlocks(config)` 的上传块视觉配置，上传行为和上传块展示配置边界更清晰。
+
+### 修复
+
+- 修复 Lucide SVG 的 `viewBox` 属性被错误转换导致图标裁切的问题。
+- 修复默认 `fill` 被覆盖后部分图标填充颜色异常的问题。
+- 修复 CodeMirror autocomplete 默认 icon 样式导致 slash command 图标尺寸异常和显示不全的问题。
+
+### 文档
+
+- 新增 `docs/icon-customization.md`，记录编辑器图标协议、开放范围、配置优先级和上传块配置关系。
+- README 增加顶层 `icons` 配置示例。
+
+## 0.7.2 - 2026-09-22
+
+### Added
+
+- Added unified image and file upload handling for paste, drag-and-drop, and batch input.
+- Added `MossMDProps.fileUpload` with upload limits, MIME filtering, kind resolution, concurrency control, retry, cancel, and abort support.
+- Added the public `mossmd/features/upload` subpath export.
+
+### Fixed
+
+- Preserved image Markdown compatibility with `![name](url)` while allowing users to add `|caption` or `|width=...` afterward.
+- Prevented file drops from falling through to CodeMirror's default text insertion.
+- Preserved batch upload order and placed the caret on a new editable line after uploaded blocks.
+- Cleaned up upload runtime state and object URLs when uploads finish, are cancelled, or the editor is destroyed.
+
+### Internal
+
+- Added upload coverage for paste, drop, batch ordering, selection replacement, cancellation, read-only mode, and image block caret placement.
+- Fixed the package consumer smoke script so its temporary Vite app builds correctly.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,336 @@
+# MossMD
+
+[![npm version](https://img.shields.io/npm/v/mossmd?color=7c3aed&labelColor=2d2d2d)](https://www.npmjs.com/package/mossmd)
+[![license](https://img.shields.io/npm/l/mossmd?color=7c3aed&labelColor=2d2d2d)](./LICENSE)
+
+MossMD （苔藓 markdown） 是一个基于 CodeMirror 6 的 Obsidian live-view 风格 Markdown 编辑器，支持自定义块语法扩展。
+
+起初是想在自己的博客系统中集成一款 markdown 编辑器，使用过 milkdown 等，但是与 obsidian 在书写体验上还是有差距，且或多或少存在不顺畅的点，于是想自己构建一款 live-view 风格的编辑器。
+
+ChatGPT 推荐了 [atomic-editor](https://github.com/kenforthewin/atomic-editor)， 当前项目可以看作是它的 fork 版本，不过后续会在 AI 协作下添加了更多自定义功能，贴近 obsidian 的使用体验，构造一些自己需要的功能点。
+
+## 特性
+
+- **实时预览**：标题、强调、`==高亮==`、链接、图片和表格会直接在编辑区内渲染，语法只在光标所在行显露。
+- **原始 Markdown 为唯一数据源**：所有装饰都只读，复制、保存、往返其它 Markdown 工具时都保持原文。
+- **布局稳定**：行高只由 CSS 类决定，点击、编辑、滚动不会让页面抖动。
+- **所见即所得表格**：单元格可直接编辑，宽表会在自身容器内横向滚动。
+- **图片块**：`Image` 节点在源码行下方渲染为块级 Widget，并缓存自然尺寸以减少虚拟滚动抖动。
+- **文件块**：单独成段的非图片文件链接渲染为带图标和扩展名徽章的卡片。
+- **Wiki 链接**：支持 `[[target]]`、`[[target|label]]`、异步解析、自动补全和点击打开。
+- **斜杠命令**：行首输入 `/` 或点击行首 `+` 触发命令面板，内置上传图片 / 文件骨架，可拼装自己的片段集。
+- **上传块**：上传过程中显示带进度与状态的块级 Widget，成功后落回最终 Markdown，失败可重试或取消；上传器由消费方注入。
+- **Callout**：识别 `> [!TYPE]` 形式的 Obsidian 风格块，非激活行收起为标签。
+- **智能列表**：Enter 可延续紧凑列表和任务列表，空条目上按 Enter 会缩出列表。
+- **代码高亮**：围栏代码块的语法在首次使用时才动态加载。
+- **自定义语法**：通过 `MossCustomSyntax` 注册额外块，适合 Callout、Mermaid、Kanban 等扩展。
+- **主题可配置**：全部颜色、字体、字号都来自 `--moss-*` CSS 变量。
+- **查找面板**：内置轻量查找面板，样式与编辑器统一。
+- **阅读模式**：`readOnly` 会把编辑器切成阅读表面，保留滚动和搜索状态。
+- **协作接口**：`CollabAdapter` 预留给 yjs、Automerge 或自定义同步层。
+
+## 安装
+
+```bash
+bun add mossmd \
+  @codemirror/state @codemirror/view @codemirror/commands \
+  @codemirror/autocomplete @codemirror/language @codemirror/search \
+  @codemirror/lang-markdown \
+  @lezer/common @lezer/highlight @lezer/markdown \
+  react react-dom
+```
+
+CodeMirror 和 React 相关包都是对等依赖，需要和编辑器一起安装。围栏代码语言语法包（例如 `@codemirror/lang-javascript`、`@codemirror/lang-python`）也是按需安装。
+
+## 使用
+
+```tsx
+import { MossMD } from 'mossmd';
+import 'mossmd/editor.css';
+
+export function App() {
+  return (
+    <MossMD
+      markdownSource={'# Hello\n\nA paragraph.'}
+      onMarkdownChange={(md) => console.log(md)}
+    />
+  );
+}
+```
+
+编辑器会撑满父容器，外层请放在有高度约束的 flex 或 grid 容器里。渲染后的 Markdown 内容如果要在编辑器外复用，请配合 `mossmd/content.css` 和 `mossmd/tokens.css`。
+
+## 命令式句柄
+
+如果需要从外部控制编辑器，可以传 `editorHandleRef`。
+
+```tsx
+import { useRef } from 'react';
+import { MossMD, type MossMDHandle } from 'mossmd';
+
+export function ToolbarDemo() {
+  const editor = useRef<MossMDHandle | null>(null);
+
+  return (
+    <>
+      <button onClick={() => editor.current?.openSearch()}>搜索</button>
+      <MossMD markdownSource={'…'} editorHandleRef={editor} />
+    </>
+  );
+}
+```
+
+可用方法包括：`focus`、`undo`、`redo`、`openSearch(query?)`、`closeSearch`、`revealText(query)`、`isSearchOpen`、`getMarkdown`、`getContentDOM`、`setReadOnly(readOnly)`、`setCollabAdapter(adapter)`。
+
+## 斜杠命令与上传
+
+`slashCommandsConfig` 接收一个命令数组和一个 `sideButton` 开关。行首输入 `/` 或点击行首 `+` 会弹出命令面板；选中后 `apply` 回调负责把 `/query` 范围替换成最终片段。
+
+```tsx
+import { MossMD } from 'mossmd';
+import { mossDefaultSlashCommands, mossUploadCommands } from 'mossmd/features';
+import type { MossUploader } from 'mossmd/features';
+
+const uploader: MossUploader = async (file, onProgress) => {
+  const form = new FormData();
+  form.append('file', file);
+  const res = await fetch('/api/upload', { method: 'POST', body: form });
+  onProgress(1);
+  return { url: (await res.json()).url };
+};
+
+const uploadCommands = mossUploadCommands(uploader);
+
+<MossMD
+  markdownSource={'…'}
+  slashCommandsConfig={{
+    commands: [...mossDefaultSlashCommands, ...uploadCommands],
+    sideButton: true,
+  }}
+/>
+```
+
+上传在 pending 期间显示一个块级进度 Widget，成功后落回最终 Markdown，失败可重试或取消。pending 状态只活在编辑器内部，不会污染原文。
+
+如果需要直接支持图片和普通文件的粘贴、拖拽及批量上传，可以把同一个 uploader
+传给 `fileUpload`。输入统一为 `File[]`，默认按 MIME 类型分流：图片生成
+`![name](url)`，普通文件生成 `[name](url)`；图片不会自动生成空的 `|caption`，
+用户仍可在图片名后输入 `|caption` 或 `|width=72%`。
+
+```tsx
+<MossMD
+  markdownSource={'…'}
+  fileUpload={{
+    uploader,
+    maxConcurrency: 3,
+    maxFiles: 20,
+    maxFileSize: 20 * 1024 * 1024,
+  }}
+/>
+```
+
+用户可见的图标可以通过顶层 `icons` 统一替换；底层仍接受返回 DOM 节点的
+`MossIconRenderer`，不绑定 Lucide。使用 Lucide 时可用 `mossLucideIcon`
+做适配：
+
+```tsx
+import { mossLucideIcon } from 'mossmd/icons';
+import { DownloadCloud, Paperclip } from 'lucide-react';
+
+<MossMD
+  markdownSource={'…'}
+  icons={{
+    file: {
+      file: mossLucideIcon(Paperclip, { size: 40 }),
+      download: mossLucideIcon(DownloadCloud, { size: 16 }),
+    },
+    upload: {
+      file: mossLucideIcon(Paperclip, { size: 22 }),
+    },
+  }}
+/>
+```
+
+## 阅读模式
+
+```tsx
+<MossMD markdownSource={'…'} readOnly />
+```
+
+阅读模式会保持整篇文档渲染，不显示光标下的源码。链接可直接打开，任务复选框仍可切换，查找功能也正常工作。`readOnly` 通过 `Compartment` 动态切换，不会重挂载编辑器。
+
+## 搜索结果落地
+
+两个 prop 可以在挂载时把用户带到相关位置：
+
+- `initialSearchText`：预填查询并打开搜索面板。
+- `initialRevealText`：直接滚动到第一个命中处，并给一个淡出高亮，不打开面板。
+
+两者都接受 `string | null`。`revealText(query)` 也可以在挂载后通过句柄触发。
+
+搜索面板默认显示在编辑器顶部，也可以放到中间或底部：
+
+```tsx
+<MossMD markdownSource={'…'} searchPanelPosition="center" />
+<MossMD markdownSource={'…'} searchPanelPosition="bottom" />
+```
+
+## 语法高亮
+
+围栏代码块默认只是等宽文本。要启用高亮，传入 `codeLanguages` 数组。
+
+```tsx
+import { MossMD } from 'mossmd';
+import { MOSS_CODE_LANGUAGES } from 'mossmd/code-languages';
+
+<MossMD markdownSource={'…'} codeLanguages={MOSS_CODE_LANGUAGES} />
+```
+
+如果你想自己组装语言列表，也可以直接传 `LanguageDescription[]`。
+
+## Wiki 链接
+
+```tsx
+import { MossMD } from 'mossmd';
+import { mossWikiLinks } from 'mossmd/features';
+
+<MossMD
+  markdownSource={'See [[project-atlas|the design doc]] for details.'}
+  extensions={[
+    mossWikiLinks({
+      suggest: async (query) => store.search(query),
+      resolve: async (target) => store.resolve(target),
+      onOpen: (target) => router.open(target),
+    }),
+  ]}
+/>
+```
+
+## 自定义语法
+
+MossMD 提供自定义语法注册层。公开入口是 `mossmd/syntax`，源码对应的协议实现落在 `src/syntax/index.ts`。语法模块会把 `markdown` 交给 `@codemirror/lang-markdown`，把 `extensions` 追加到编辑器扩展集合之后。
+
+```tsx
+import { MossMD } from 'mossmd';
+import { mossCalloutSyntax } from 'mossmd/features';
+
+<MossMD
+  markdownSource={markdown}
+  customSyntax={[mossCalloutSyntax()]}
+/>
+```
+
+如果你要自己定义模块，可以从 `mossmd/syntax` 引入 `defineMossSyntax`：
+
+```ts
+import { defineMossSyntax } from 'mossmd/syntax';
+
+export const calloutSyntax = defineMossSyntax({
+  name: 'callout',
+  description: 'Callout 块',
+  markdown: calloutMarkdown,
+  extensions: calloutDecorations(),
+});
+```
+
+内置的 Callout 模块识别 `> [!TYPE]` 这种 blockquote 结构。非激活行会显示紧凑标签，点回首行后再恢复原始标记，方便继续编辑。
+
+## 主题
+
+所有颜色、字体、字号都来自 CSS 自定义属性。你可以在编辑器祖先节点上覆盖这些变量，也可以通过 `data-theme="light"` 切换到浅色配色。MossMD 还提供两个蓝色 preset：`data-theme="blue"` 是深海蓝主题，`data-theme="blue-light"` 是浅蓝主题；它们只改变主题 token，不增加编辑器配置。蓝色 preset 与明暗模式是两个独立维度，可以分别选择配色和明暗：
+
+- `data-theme="blue"`：蓝色深色
+- `data-theme="blue-light"`：蓝色浅色
+- `data-theme="dark"`：默认深色
+- `data-theme="light"`：默认浅色
+
+`mossmd/tokens.css` 提供共享主题令牌，`mossmd/editor.css` 负责编辑器表面样式，`mossmd/content.css` 负责渲染后的 Markdown。
+
+```tsx
+import { MossMD } from 'mossmd';
+import 'mossmd/editor.css';
+
+export function BlueMoss() {
+  return (
+    <div data-theme="blue">
+      <MossMD markdownSource="# Blue Moss" />
+    </div>
+  );
+}
+```
+
+图片块会在图片上显示预览按钮；点击后在编辑器外打开大图预览，不会修改 Markdown 或改变文档布局。编辑模式下还会显示编辑和缩放按钮，可修改 alt 文本、图片标题、宽度和 URL。点击图片会选中完整的原始图片语法，因此复制、删除仍然作用于 Markdown 源文。触摸设备上按钮会自动使用较大的常驻触控目标；如需关闭编辑、缩放或预览，可以传入 `imagesConfig={{ editable: false, resizable: false, previewable: false }}`。
+
+宽度会使用 MossMD 的扩展图片语法保存，例如 `![alt|caption|width=72%](url)`。旧的 `![alt](url)` 和 `![alt|caption](url)` 格式仍然兼容。
+
+独立成行的文件链接会渲染为文件块并始终隐藏源码。编辑模式下文件块提供下载和删除操作；只读模式下仅提供下载操作。
+
+任务列表支持扩展状态，例如 `- [/] In Progress`、`- [!] Important` 和
+`- [\\*] Star`。内置状态会直接渲染为对应图标；也可以通过
+`inlinePreviewConfig.taskCheckboxes` 覆盖图标、名称、是否填充，或增加自定义状态：
+
+```tsx
+import { CircleAlert } from 'lucide-react';
+
+<MossMD
+  markdownSource={'- [!] Important'}
+  inlinePreviewConfig={{
+    taskCheckboxes: {
+      '!': { icon: CircleAlert, label: 'Important' },
+    },
+  }}
+/>
+```
+
+标准 `[ ]`/`[x]` 会互相切换；自定义状态使用状态字符和带 `-` 前缀的状态字符表示填充态与空白态，例如 `[A]` 和 `[-A]`。用户也可以通过 `toggleTo` 自定义两个状态之间的切换。
+
+水平分隔线支持普通语法和对称图标语法。默认语法不带图标：`---` 为普通直线，`***` 为舒缓波浪线，`___` 为普通分隔线。需要图标时，将图标放在两侧相同的分隔符之间：
+
+```tsx
+<MossMD
+  markdownSource={'---⭐---\n***🌿***'}
+/>
+```
+
+`---⭐---` 会渲染为带 `⭐` 的直线，`***🌿***` 会渲染为带 `🌿` 的波浪线。图标内容来自 Markdown 原文，因此复制、保存和协作同步都能保留它。
+
+## 底层组合
+
+如果你不想使用完整的 React 包装，可以直接把各个模块拼起来：
+
+```ts
+import {
+  mossInlinePreview,
+  mossTheme,
+  mossSyntax,
+  extendEmphasisPair,
+} from 'mossmd';
+import {
+  mossImages,
+  mossFileBlocks,
+  mossTables,
+  mossWikiLinks,
+  mossCallouts,
+  mossSlashCommands,
+  mossUploadBlocks,
+} from 'mossmd/features';
+```
+
+上述函数都是独立的 CM6 模块，可以按需组合。
+
+## 协作
+
+`CollabAdapter` 预留给协作同步层。默认实现是 `noopCollabAdapter`，只是不做任何事。未来如果接入 yjs 或别的同步方案，只要实现 `attach`、`detach`、`onRemoteChange` 就行。
+
+## 设计说明
+
+更完整的架构说明见 [docs/architecture.md](./docs/architecture.md)。
+
+- 原始 Markdown 是唯一数据源
+- 行高只由 CSS 类控制
+- 鼠标按下后会短暂冻结装饰重建
+- 装饰重建只覆盖受影响的范围
+
+## 许可证
+
+MIT。见 [LICENSE](./LICENSE)。

package/dist/collab/index.d.ts

@@ -0,0 +1,14 @@
+import { EditorView } from '@codemirror/view';
+export interface CollabAdapter {
+    attach(view: EditorView): Promise<void>;
+    detach(): void | Promise<void>;
+    /**
+     * Subscribe to full-document snapshots produced by a remote source.
+     * The editor applies snapshots as `Transaction.remote` replacements
+     * so local change listeners still see the new markdown.
+     */
+    onRemoteChange(cb: (doc: string) => void): () => void;
+    getAwareness?(): unknown;
+}
+export declare const noopCollabAdapter: CollabAdapter;
+//# sourceMappingURL=index.d.ts.map

package/dist/collab/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/collab/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B;;;;OAIG;IACH,cAAc,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACtD,YAAY,CAAC,IAAI,OAAO,CAAC;CAC1B;AAED,eAAO,MAAM,iBAAiB,EAAE,aAI/B,CAAC"}

package/dist/collab/index.js

@@ -0,0 +1,6 @@
+export const noopCollabAdapter = {
+    attach: async () => { },
+    detach: () => { },
+    onRemoteChange: () => () => { },
+};
+//# sourceMappingURL=index.js.map

package/dist/collab/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/collab/index.ts"],"names":[],"mappings":"AAcA,MAAM,CAAC,MAAM,iBAAiB,GAAkB;IAC9C,MAAM,EAAE,KAAK,IAAI,EAAE,GAAE,CAAC;IACtB,MAAM,EAAE,GAAG,EAAE,GAAE,CAAC;IAChB,cAAc,EAAE,GAAG,EAAE,CAAC,GAAG,EAAE,GAAE,CAAC;CAC/B,CAAC"}

package/dist/core/code-languages.d.ts

@@ -0,0 +1,3 @@
+import { LanguageDescription } from '@codemirror/language';
+export declare const MOSS_CODE_LANGUAGES: LanguageDescription[];
+//# sourceMappingURL=code-languages.d.ts.map

package/dist/core/code-languages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-languages.d.ts","sourceRoot":"","sources":["../../src/core/code-languages.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EAIpB,MAAM,sBAAsB,CAAC;AAe9B,eAAO,MAAM,mBAAmB,EAAE,mBAAmB,EAsHpD,CAAC"}

package/dist/core/code-languages.js

@@ -0,0 +1,130 @@
+import { LanguageDescription, LanguageSupport, StreamLanguage, } from '@codemirror/language';
+// Curated list of languages offered for fenced code blocks. Each `load()` is a
+// dynamic import so Rollup splits the grammar into its own lazy chunk — users
+// only download the ones they actually use.
+//
+// We deliberately avoid `@codemirror/language-data`'s full catalog (50+
+// grammars, ~1 MB) and ship only what we write. To add a language: install
+// `@codemirror/lang-<name>` (or pull a stream parser from
+// `@codemirror/legacy-modes`) and append an entry here.
+function legacy(parser) {
+    return new LanguageSupport(StreamLanguage.define(parser));
+}
+export const MOSS_CODE_LANGUAGES = [
+    LanguageDescription.of({
+        name: 'JavaScript',
+        alias: ['js', 'jsx'],
+        extensions: ['js', 'mjs', 'cjs', 'jsx'],
+        load: () => import('@codemirror/lang-javascript').then((m) => m.javascript({ jsx: true })),
+    }),
+    LanguageDescription.of({
+        name: 'TypeScript',
+        alias: ['ts', 'tsx'],
+        extensions: ['ts', 'mts', 'cts', 'tsx'],
+        load: () => import('@codemirror/lang-javascript').then((m) => m.javascript({ typescript: true, jsx: true })),
+    }),
+    LanguageDescription.of({
+        name: 'Python',
+        alias: ['py'],
+        extensions: ['py'],
+        load: () => import('@codemirror/lang-python').then((m) => m.python()),
+    }),
+    LanguageDescription.of({
+        name: 'Go',
+        extensions: ['go'],
+        load: () => import('@codemirror/lang-go').then((m) => m.go()),
+    }),
+    LanguageDescription.of({
+        name: 'Rust',
+        alias: ['rs'],
+        extensions: ['rs'],
+        load: () => import('@codemirror/lang-rust').then((m) => m.rust()),
+    }),
+    LanguageDescription.of({
+        name: 'Ruby',
+        alias: ['rb'],
+        extensions: ['rb'],
+        load: () => import('@codemirror/legacy-modes/mode/ruby').then((m) => legacy(m.ruby)),
+    }),
+    LanguageDescription.of({
+        name: 'Java',
+        extensions: ['java'],
+        load: () => import('@codemirror/lang-java').then((m) => m.java()),
+    }),
+    LanguageDescription.of({
+        name: 'C',
+        extensions: ['c', 'h'],
+        load: () => import('@codemirror/lang-cpp').then((m) => m.cpp()),
+    }),
+    LanguageDescription.of({
+        name: 'C++',
+        alias: ['cpp'],
+        extensions: ['cpp', 'c++', 'cc', 'cxx', 'hpp', 'h++', 'hh', 'hxx'],
+        load: () => import('@codemirror/lang-cpp').then((m) => m.cpp()),
+    }),
+    LanguageDescription.of({
+        name: 'PHP',
+        extensions: ['php'],
+        load: () => import('@codemirror/lang-php').then((m) => m.php()),
+    }),
+    LanguageDescription.of({
+        name: 'Swift',
+        extensions: ['swift'],
+        load: () => import('@codemirror/legacy-modes/mode/swift').then((m) => legacy(m.swift)),
+    }),
+    LanguageDescription.of({
+        name: 'Shell',
+        alias: ['bash', 'sh', 'zsh'],
+        extensions: ['sh', 'bash', 'zsh'],
+        load: () => import('@codemirror/legacy-modes/mode/shell').then((m) => legacy(m.shell)),
+    }),
+    LanguageDescription.of({
+        name: 'SQL',
+        extensions: ['sql'],
+        load: () => import('@codemirror/lang-sql').then((m) => m.sql()),
+    }),
+    LanguageDescription.of({
+        name: 'HTML',
+        alias: ['htm'],
+        extensions: ['html', 'htm'],
+        load: () => import('@codemirror/lang-html').then((m) => m.html()),
+    }),
+    LanguageDescription.of({
+        name: 'CSS',
+        extensions: ['css'],
+        load: () => import('@codemirror/lang-css').then((m) => m.css()),
+    }),
+    LanguageDescription.of({
+        name: 'XML',
+        extensions: ['xml'],
+        load: () => import('@codemirror/lang-xml').then((m) => m.xml()),
+    }),
+    LanguageDescription.of({
+        name: 'JSON',
+        extensions: ['json'],
+        load: () => import('@codemirror/lang-json').then((m) => m.json()),
+    }),
+    LanguageDescription.of({
+        name: 'YAML',
+        alias: ['yml'],
+        extensions: ['yaml', 'yml'],
+        load: () => import('@codemirror/lang-yaml').then((m) => m.yaml()),
+    }),
+    LanguageDescription.of({
+        name: 'TOML',
+        extensions: ['toml'],
+        load: () => import('@codemirror/legacy-modes/mode/toml').then((m) => legacy(m.toml)),
+    }),
+    LanguageDescription.of({
+        name: 'Dockerfile',
+        filename: /^Dockerfile$/,
+        load: () => import('@codemirror/legacy-modes/mode/dockerfile').then((m) => legacy(m.dockerFile)),
+    }),
+    LanguageDescription.of({
+        name: 'Markdown',
+        alias: ['md'],
+        extensions: ['md', 'markdown', 'mkd'],
+        load: () => import('@codemirror/lang-markdown').then((m) => m.markdown()),
+    }),
+];
+//# sourceMappingURL=code-languages.js.map

package/dist/core/code-languages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-languages.js","sourceRoot":"","sources":["../../src/core/code-languages.ts"],"names":[],"mappings":"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"}

package/dist/core/decoration-utils.d.ts

@@ -0,0 +1,4 @@
+import { Decoration } from '@codemirror/view';
+import type { Range, Text } from '@codemirror/state';
+export declare function pushReplace(ranges: Range<Decoration>[], doc: Text, from: number, to: number, spec?: Parameters<typeof Decoration.replace>[0]): void;
+//# sourceMappingURL=decoration-utils.d.ts.map

package/dist/core/decoration-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decoration-utils.d.ts","sourceRoot":"","sources":["../../src/core/decoration-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAKrD,wBAAgB,WAAW,CACzB,MAAM,EAAE,KAAK,CAAC,UAAU,CAAC,EAAE,EAC3B,GAAG,EAAE,IAAI,EACT,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,IAAI,GAAE,UAAU,CAAC,OAAO,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAM,GAClD,IAAI,CAqBN"}

package/dist/core/decoration-utils.js

@@ -0,0 +1,25 @@
+import { Decoration } from '@codemirror/view';
+// ViewPlugin-sourced Decoration.replace ranges cannot cross a line break.
+// Split multiline syntax into per-line ranges while keeping the newline in
+// the document flow for stable height and position mapping.
+export function pushReplace(ranges, doc, from, to, spec = {}) {
+    if (from >= to)
+        return;
+    const startLine = doc.lineAt(from);
+    if (to <= startLine.to) {
+        ranges.push(Decoration.replace(spec).range(from, to));
+        return;
+    }
+    let cursor = from;
+    let firstSegment = true;
+    while (cursor < to) {
+        const line = doc.lineAt(cursor);
+        const segmentEnd = Math.min(to, line.to);
+        if (segmentEnd > cursor) {
+            ranges.push(Decoration.replace(firstSegment ? spec : {}).range(cursor, segmentEnd));
+            firstSegment = false;
+        }
+        cursor = line.to + 1;
+    }
+}
+//# sourceMappingURL=decoration-utils.js.map

package/dist/core/decoration-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decoration-utils.js","sourceRoot":"","sources":["../../src/core/decoration-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C,0EAA0E;AAC1E,2EAA2E;AAC3E,4DAA4D;AAC5D,MAAM,UAAU,WAAW,CACzB,MAA2B,EAC3B,GAAS,EACT,IAAY,EACZ,EAAU,EACV,OAAiD,EAAE;IAEnD,IAAI,IAAI,IAAI,EAAE;QAAE,OAAO;IACvB,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,EAAE,IAAI,SAAS,CAAC,EAAE,EAAE,CAAC;QACvB,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;QACtD,OAAO;IACT,CAAC;IAED,IAAI,MAAM,GAAG,IAAI,CAAC;IAClB,IAAI,YAAY,GAAG,IAAI,CAAC;IACxB,OAAO,MAAM,GAAG,EAAE,EAAE,CAAC;QACnB,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAChC,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;QACzC,IAAI,UAAU,GAAG,MAAM,EAAE,CAAC;YACxB,MAAM,CAAC,IAAI,CACT,UAAU,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,MAAM,EAAE,UAAU,CAAC,CACvE,CAAC;YACF,YAAY,GAAG,KAAK,CAAC;QACvB,CAAC;QACD,MAAM,GAAG,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}