@sigma-studio/editor 0.467.1 → 0.468.0

package/README.md

@@ -14,6 +14,7 @@ SigmaDoc教材のWeb編集をReactサイトへ組み込むEditorパッケージ
 - `SigmaDocViewer`: 問題・解答・コメントの出し分け、問題番号上書き、高さ制限を持つRead専用表示
 - `SigmaDocEditor`: デスクトップ版と同じ編集UIを組み込み、`onChange` / `onSave`へ完全なSigmaDocumentを返すcontrolled editor
 - `parseSigmaDocument`: 外部JSONを正規スキーマで検証
+- `importTexDocument` / `importTexProblem`: TeX文書、または問題文・解説の別フィールドをSigmaDocへ変換
 
 教材一覧、認証、データ取得、永続化、AI/MCP、Electron API、デスクトップ専用の教材import機能は含みません。これらは組み込み先のアプリが担当します。
 
@@ -74,6 +75,28 @@ export function AnswerPage({ document }: { document: SigmaDocument }) {
 
 `visibleParts`は`problem`、`solution`、`comments`を自由に組み合わせられます。未指定なら完全版です。`maxHeightPx`を超えた場合だけFadeと「すべて表示」を出します。
 
+## TeXの問題を取り込む
+
+```ts
+import { importTexDocument, importTexProblem } from "@sigma-studio/editor";
+
+// .texファイル全体、または本文だけのTeX
+const document = importTexDocument(texSource, "入試問題.tex");
+
+// 問題投稿フォームなどの、別々に管理された問題文と解説
+const problem = importTexProblem({
+  title: "二次関数の最小値",
+  preamble: String.raw`\providecommand{\sq}[1]{#1^2}`,
+  prompt: String.raw`$f(x)=\sq{x}+1$ の最小値を求めよ。`,
+  solution: String.raw`$\sq{x}\geq0$ より、最小値は $1$。`,
+  tags: ["数と式"],
+});
+```
+
+返り値を `SigmaDocEditor.document` または `SigmaDocViewer.document` に渡せます。変換ごとに新しい文書IDを発行します。`prompt` と `solution`、任意の `hints` はSigmaDocの問題エリアに分かれ、マクロは同じ問題内で共有されます。変換時のエラーは例外として返すため、呼び出し元で表示してください。
+
+受験数学研究所のTeXに使われる必須引数マクロ、`enumerate` の数字付き小問、`label=(\arabic*)`、`start=`、`\item[(1)]`、別行数式、`aligned` / `cases` / 行列に対応します。任意のLaTeXパッケージは実行しません。TikZや未対応の表・環境は、描画の代わりに編集可能なTeXソースとして残します。
+
 ## Editorを使う
 
 ```tsx

package/dist/index.d.ts

@@ -2,3 +2,4 @@ import "./styles.css";
 export { SigmaDocEditor, type SigmaDocEditorChange, type SigmaDocEditorHandle, type SigmaDocEditorProps, type SigmaDocEditorSaveState, } from "./SigmaDocEditor.js";
 export { SigmaDocParseError, SigmaDocViewer, parseSigmaDocument, type SigmaDocViewerError, type SigmaDocViewerPart, type SigmaDocViewerProps, } from "@sigma-studio/viewer";
 export type * from "@sigma-studio/viewer";
+export { importTexDocument, importTexProblem, type TexProblemInput } from "./tex-import.js";