Astlide 3 への移行

Astro プロジェクトの移行手順

1. パッケージを入れ替えます。@astlide/astro を入れると、@astlide/core と astlide コマンドも一緒に入ります。

   bun remove @astlide/core
   bun add @astlide/astro

2. インテグレーションを @astlide/astro から読み込みます。

   astro.config.mjs

   import astlide from "@astlide/astro"; // 以前は "@astlide/core"

3. ローダーとスキーマも @astlide/astro から読み込みます。

   src/content.config.ts

   import { astlideDeckLoader, slideSchema } from "@astlide/astro"; // 以前は "@astlide/core"

4. Astlide のコンポーネントなどを直接 import している場合は、次の表のとおりにパスを書き換えます。

   Astlide 2	Astlide 3
   @astlide/core（インテグレーション、astlideDeckLoader）	@astlide/astro
   @astlide/core/loader	@astlide/astro/loader
   @astlide/core/components/*.astro	@astlide/astro/components/*.astro
   @astlide/core/internal/diagrams	@astlide/core/runtime/diagrams
   @astlide/core/internal/recording	@astlide/core/runtime/media
   @astlide/core/internal/pdf-export	@astlide/core/runtime/pdf-export
   末尾が .ts のパス（@astlide/core/utils/network.ts など）	.ts を取ったパス

   これ以外の @astlide/core/internal/* と、utils/csp・utils/favicon・utils/pptx-templates・utils/slide-mark は import できなくなります。どれもドキュメントに載せていない内部用のモジュールです。これらを使っている場合は issue で用途を教えてください。

次のものは今までと同じ場所にあります：@astlide/core/schema・/plugin・/context・/embed・/pptx・/templates・/mcp・/styles/*、ドキュメントで案内している utils/base-path・utils/code-highlight・utils/mermaid。@astlide/core 自体からも、スキーマ、defineAstlidePlugin、getDeckContext / getClientDeckContext を引き続き import できます。

プラグイン

プラグインは今までどおり @astlide/core/plugin から defineAstlidePlugin を import します。peer dependency は @astlide/core の 3 に上げてください。レイアウトを .astro のコンポーネントで提供しているなら、@astlide/astro の 3 にします。