@cardenelabs/dragon 0.36.2 → 0.36.4

package/README.md

@@ -25,6 +25,30 @@ npm install @cardenelabs/dragon
 | 描く部品 | 原本から時系列図と構成図を描き、段ごとに動かす部品。cdl には頼らない |
 | 書き出し | 同じ原本から mp4、GIF、HTML、PNG を書き出す命令 |
 
+## 頁に置く
+
+頁で 1 度だけ字の入口 `@cardenelabs/dragon/fonts` を import し、記法を読んだ原本を `mountDiagram` に渡す。
+
+```ts
+import "@cardenelabs/dragon/fonts";
+import { mountDiagram, parseNotation } from "@cardenelabs/dragon";
+
+const source = await (await fetch("login.dragon")).text();
+const parsed = parseNotation(source);
+if (!parsed.ok) throw new Error(parsed.errors.map((e) => `${e.line}: ${e.message}`).join("\n"));
+
+const host = document.getElementById("figure");
+if (host === null) throw new Error("図を置く要素が無い");
+const player = mountDiagram(host, parsed.diagram);
+```
+
+字の入口は、同梱の 2 つの字 (Noto Sans JP と JetBrains Mono) の CSS を読み込むだけで、何も出さない。
+図は同梱の字で測った字の幅で組むため、読み込まないと端末の字で描かれ、札から字がはみ出すことがある。
+CSS と字の file は、束ねる道具 (Vite など) が頁へ運ぶ。
+
+`mountDiagram` が返す `player` で段を動かす (`next`、`prev`、`play`、`pause`、`destroy`)。
+3 つめの引数には色味や段が替わった時に呼ぶ関数などの設定 (`PlayerOptions`) を渡す。
+
 ## dragon記法
 
 どの行も次の決まり 4 つに従う。

package/dist/index.d.cts

@@ -272,4 +272,4 @@ declare function chooseView(rendered: Pick<Rendered, "layout" | "view">, frameWi
     textPx: number;
 };
 
-export { Carry, CheckOptions, Diagram, FONTS, FORMAT_VERSION, type Fence, FieldError, type Layout, type LineError, type Migrated, NotationLang, type ParseOptions, type Parsed, type Player, type PlayerOptions, type Read, type RenderOptions, type Rendered, Theme, type Timeline, ViewMode, chooseView, extractDiagrams, migrateFile, mountDiagram, parseNotation, printNotation, readDiagram, renderDiagram };
+export { type CarrierTime, Carry, CheckOptions, ColorKey, Diagram, type EdgeTime, type EventTime, FONTS, FORMAT_VERSION, type Family, type Fence, FieldError, type LabelTime, type Layout, type LineError, type Migrated, NotationLang, type ParseOptions, type Parsed, type Player, type PlayerOptions, type Point, type Read, type Rect, type RenderOptions, type Rendered, type SceneAction, type SceneBadge, type SceneBox, type SceneEdge, type SceneField, type SceneLabel, type SceneLifeline, type SceneRegion, type SceneStrip, type Span, Theme, type Timeline, ViewMode, chooseView, extractDiagrams, migrateFile, mountDiagram, parseNotation, printNotation, readDiagram, renderDiagram };

package/dist/index.d.ts

@@ -272,4 +272,4 @@ declare function chooseView(rendered: Pick<Rendered, "layout" | "view">, frameWi
     textPx: number;
 };
 
-export { Carry, CheckOptions, Diagram, FONTS, FORMAT_VERSION, type Fence, FieldError, type Layout, type LineError, type Migrated, NotationLang, type ParseOptions, type Parsed, type Player, type PlayerOptions, type Read, type RenderOptions, type Rendered, Theme, type Timeline, ViewMode, chooseView, extractDiagrams, migrateFile, mountDiagram, parseNotation, printNotation, readDiagram, renderDiagram };
+export { type CarrierTime, Carry, CheckOptions, ColorKey, Diagram, type EdgeTime, type EventTime, FONTS, FORMAT_VERSION, type Family, type Fence, FieldError, type LabelTime, type Layout, type LineError, type Migrated, NotationLang, type ParseOptions, type Parsed, type Player, type PlayerOptions, type Point, type Read, type Rect, type RenderOptions, type Rendered, type SceneAction, type SceneBadge, type SceneBox, type SceneEdge, type SceneField, type SceneLabel, type SceneLifeline, type SceneRegion, type SceneStrip, type Span, Theme, type Timeline, ViewMode, chooseView, extractDiagrams, migrateFile, mountDiagram, parseNotation, printNotation, readDiagram, renderDiagram };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cardenelabs/dragon",
-  "version": "0.36.2",
+  "version": "0.36.4",
   "description": "Dragon — 動く図を、人は行ごとの記法で、AI は JSON で書く。時系列図と構成図を段ごとに動かし、mp4・GIF・HTML・PNG に書き出す。",
   "license": "MIT",
   "author": "cardene777",

package/src/index.ts

@@ -25,10 +25,23 @@ export {
   type ViewMode,
 } from "./schema";
 export { FORMAT_VERSION, type Migrated, migrateFile, type Read, readDiagram } from "./version";
-export type { Layout } from "./layout/scene";
-export { FONTS } from "./look/fonts";
-export { DEFAULT_PALETTE, type Palette, PALETTES, READABLE_PX, resolvePalette, type Theme } from "./look/values";
+export type {
+  Layout,
+  Point,
+  Rect,
+  SceneAction,
+  SceneBadge,
+  SceneBox,
+  SceneEdge,
+  SceneField,
+  SceneLabel,
+  SceneLifeline,
+  SceneRegion,
+  SceneStrip,
+} from "./layout/scene";
+export { type Family, FONTS } from "./look/fonts";
+export { type ColorKey, DEFAULT_PALETTE, type Palette, PALETTES, READABLE_PX, resolvePalette, type Theme } from "./look/values";
 export { mountDiagram, type Player, type PlayerOptions } from "./player";
 export { type Rendered, type RenderOptions, renderDiagram } from "./render/svg";
-export type { Timeline } from "./timeline";
+export type { CarrierTime, EdgeTime, EventTime, LabelTime, Span, Timeline } from "./timeline";
 export { chooseView } from "./view";