@cosense-toolbox/astro 0.1.0-beta.2

package/dist/index.mjs

@@ -0,0 +1,581 @@
+import { fileURLToPath } from "node:url";
+import { buildGraph, createIndex, readPage } from "@cosense-toolbox/cosense-x/graph";
+import { Array, Effect, Match, Option, pipe } from "effect";
+import { createHash } from "node:crypto";
+import { copyFile, mkdir, readFile, readdir, stat, writeFile } from "node:fs/promises";
+import { basename, extname, join, relative, sep } from "node:path";
+import { fetchAsset, isCosenseAssetUrl } from "@cosense-toolbox/cosense-x/fetch";
+import { codeLanguageOf } from "@cosense-toolbox/parser/html";
+import { bundledLanguages, createHighlighter } from "shiki";
+import { checkSite } from "@cosense-toolbox/lsp/check";
+import { createReadStream } from "node:fs";
+import { compile } from "@cosense-toolbox/cosense-x";
+//#region src/assets.ts
+/**
+* assets.ts — Cosense 上の画像やファイルを、ビルド時に取ってきてサイトの中に置く。
+*
+* Cosense のファイル (`/files/…`) とアイコン (`/api/pages/…/icon`) は
+* `Cross-Origin-Resource-Policy: same-origin` を返すので、別のサイトの `<img>` からは読めない。
+* リダイレクト先も期限付きの URL (`/files/` は 5 分で切れる) なので、URL を解決して埋め込むだけでは
+* 公開する頃には表示されなくなる。そのため中身を取ってきて、サイトと同じ場所に置く。
+*/
+/** `globalThis` に置き場を置くときのキー (`Symbol.for` に渡す)。 */
+const ASSET_STORE_KEY = "@cosense-toolbox/astro/assets";
+/** Content-Type から付ける拡張子。静的なホスティングは拡張子で Content-Type を決めるため。 */
+const EXTENSIONS$1 = {
+	"image/png": ".png",
+	"image/jpeg": ".jpg",
+	"image/gif": ".gif",
+	"image/webp": ".webp",
+	"image/avif": ".avif",
+	"image/svg+xml": ".svg",
+	"image/x-icon": ".ico",
+	"application/pdf": ".pdf",
+	"video/mp4": ".mp4",
+	"audio/mpeg": ".mp3"
+};
+/** Content-Type で決まらなければ、元の URL の拡張子を使う。 */
+const extensionOf = (url, contentType) => {
+	const known = EXTENSIONS$1[contentType.split(";")[0]?.trim().toLowerCase() ?? ""];
+	if (known !== void 0) return known;
+	return /\.[A-Za-z0-9]{1,5}$/.exec(new URL(url).pathname)?.[0]?.toLowerCase() ?? "";
+};
+/**
+* 元の URL のハッシュ。同じ URL は何度ビルドしても同じ名前になり、ハッシュから元の URL
+* (アップロードしたファイルの ID) は分からない。非公開プロジェクトのファイル ID を出さないため。
+*/
+const hashOf = (url) => createHash("sha256").update(url).digest("hex").slice(0, 16);
+const ICON_RE = /^\/api\/pages\/[^/]+\/(.+)\/icon$/;
+const decode = (segment) => {
+	try {
+		return decodeURIComponent(segment);
+	} catch {
+		return segment;
+	}
+};
+/** ファイル名や URL に使えない文字を `_` にする。日本語はそのまま残す。 */
+const sanitize = (label) => label.replace(/[\\/?#%:*"<>|\s\p{Cc}]+/gu, "_").replace(/_+/g, "_").replace(/^_|_$/g, "").slice(0, 60);
+/**
+* 人が見て何のファイルか分かるよう、ハッシュのあとに付ける名前。アイコンはユーザー名
+* (ページには `<img alt>` としてもともと出ている)。アップロードしたファイルは ID を出さないので付けない。
+*/
+const labelOf = (url) => {
+	const title = ICON_RE.exec(new URL(url).pathname)?.[1];
+	return title === void 0 ? "" : sanitize(title.split("/").map(decode).join("_"));
+};
+/** アップロードしたファイル (`/files/…`) は中身が変わらないので、前のビルドで取ったものを使い回せる。 */
+const isImmutable = (url) => new URL(url).pathname.startsWith("/files/");
+const unescapeAttribute = (value) => value.replace(/&quot;/g, "\"").replace(/&#39;/g, "'").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&amp;/g, "&");
+const ATTRIBUTE_RE = /(\s(src|href)=")([^"]*)(")/g;
+const createAssetStore = (options) => {
+	const fetchOptions = options.fetchOptions ?? {};
+	const isAsset = (url) => isCosenseAssetUrl(url, fetchOptions);
+	const downloads = /* @__PURE__ */ new Map();
+	const used = /* @__PURE__ */ new Set();
+	const publicUrlOf = (file) => {
+		used.add(file);
+		return `${options.publicPath}${encodeURIComponent(file)}`;
+	};
+	/** 前のビルドで置いたファイル。拡張子は取ってくるまで分からないので、ハッシュで探す。 */
+	const cachedFileOf = async (base) => {
+		return (await readdir(options.cacheDir).catch(() => [])).find((file) => file === base || file.startsWith(`${base}.`));
+	};
+	const download = async (url) => {
+		const label = labelOf(url);
+		const base = label === "" ? hashOf(url) : `${hashOf(url)}_${label}`;
+		try {
+			const cached = isImmutable(url) ? await cachedFileOf(base) : void 0;
+			if (cached !== void 0) return publicUrlOf(cached);
+			const asset = await fetchAsset(url, fetchOptions);
+			const file = `${base}${extensionOf(url, asset.contentType)}`;
+			await mkdir(options.cacheDir, { recursive: true });
+			await writeFile(join(options.cacheDir, file), asset.data);
+			return publicUrlOf(file);
+		} catch (error) {
+			options.warn?.(`${url} を取得できないので、元の URL のまま出す: ${String(error)}`);
+			return url;
+		}
+	};
+	const resolve = (url) => {
+		if (!isAsset(url)) return Promise.resolve(url);
+		const cached = downloads.get(url) ?? download(url);
+		downloads.set(url, cached);
+		return cached;
+	};
+	const resolveLink = (url) => options.links === "download" ? resolve(url) : Promise.resolve(url);
+	const resolveAttribute = (name, url) => name === "href" ? resolveLink(url) : resolve(url);
+	const localizeHtml = async (html) => {
+		const targets = [...html.matchAll(ATTRIBUTE_RE)].map((match) => [match[2] ?? "", unescapeAttribute(match[3] ?? "")]).filter(([, url]) => isAsset(url));
+		const resolved = new Map(await Promise.all(targets.map(async ([name, url]) => [`${name} ${url}`, await resolveAttribute(name, url)])));
+		return html.replace(ATTRIBUTE_RE, (whole, open, name, value, close) => {
+			const local = resolved.get(`${name} ${unescapeAttribute(value)}`);
+			return local === void 0 ? whole : `${open}${local}${close}`;
+		});
+	};
+	const copyUsedTo = async (dir) => {
+		const target = dir instanceof URL ? fileURLToPath(dir) : dir;
+		await mkdir(target, { recursive: true });
+		await Promise.all([...used].map((file) => copyFile(join(options.cacheDir, file), join(target, file))));
+	};
+	return {
+		resolve,
+		resolveLink,
+		localizeHtml,
+		copyUsedTo,
+		cacheDir: options.cacheDir,
+		publicPath: options.publicPath
+	};
+};
+/** `img` の `src` と `a` の href。書き換えられるよう、要素とプロパティ名の組で返す。 */
+const referencesIn = (node) => {
+	const own = node.type === "element" && node.properties !== void 0 ? node.tagName === "img" ? [[node.properties, "src"]] : node.tagName === "a" ? [[node.properties, "href"]] : [] : [];
+	const nested = [
+		...node.children ?? [],
+		node.fallback,
+		node.fallbackEnd
+	].filter((child) => child !== null && child !== void 0);
+	return [...own, ...nested.flatMap(referencesIn)];
+};
+/** `.csn` / `.csnx` の hast の中で、Cosense 上のファイルを指す URL を差し替える rehype プラグイン。 */
+const rehypeCosenseAssets = (store) => () => async (tree) => {
+	await Promise.all(referencesIn(tree).map(async ([properties, key]) => {
+		const value = properties[key];
+		if (typeof value !== "string") return;
+		properties[key] = key === "href" ? await store.resolveLink(value) : await store.resolve(value);
+	}));
+};
+//#endregion
+//#region src/highlight.ts
+/** 行頭 (字下げの後) の `code:ファイル名` からコードブロックを見つける。 */
+const CODE_BLOCK = /^[ \t]*code:(.+)$/gm;
+/** ページに出てくるコードブロックの言語名。`highlight` に渡るのと同じ決め方。 */
+const codeLanguagesIn = (source) => [...new Set([...source.matchAll(CODE_BLOCK)].map((match) => codeLanguageOf((match[1] ?? "").trim())))];
+/** shiki を使う設定なら、色付けしない言語 (`excludeLangs`) の一覧。shiki を使わない設定なら None。 */
+const shikiExclusionsOf = (setting) => Match.value(setting).pipe(Match.when("shiki", () => Option.some([])), Match.when({ type: "shiki" }, (config) => Option.some(config.excludeLangs ?? [])), Match.orElse(() => Option.none()));
+/**
+* Astro の Markdown の設定で色付けする。shiki を使わない設定 (`false` や `'prism'`) なら undefined。
+* prism には相当するものが無いので、色付けしない。
+*/
+const astroShikiHighlighter = (markdown) => pipe(shikiExclusionsOf(markdown.syntaxHighlight), Option.map((excluded) => shikiHighlighter(markdown.shikiConfig, new Set(excluded))), Option.getOrUndefined);
+const shikiHighlighter = ({ langs, langAlias, theme, themes, defaultColor, transformers }, excluded) => {
+	const multiple = Object.keys(themes).length > 0;
+	const themed = multiple ? {
+		themes,
+		...defaultColor === void 0 ? {} : { defaultColor }
+	} : { theme };
+	const shiki = Effect.runSync(Effect.cached(Effect.promise(() => createHighlighter({
+		themes: multiple ? Object.values(themes) : [theme],
+		langs
+	}))));
+	const resolve = (language) => Option.getOrElse(Option.fromNullable(langAlias[language]), () => language);
+	/** ページに出てくる言語のうち、読み込んでいないものを読み込む。shiki が知らない言語は飛ばす。 */
+	const loadLanguagesIn = (source) => (highlighter) => {
+		const loaded = new Set(highlighter.getLoadedLanguages());
+		const wanted = codeLanguagesIn(source).map(resolve).filter((language) => !excluded.has(language) && !loaded.has(language)).filter((language) => language in bundledLanguages);
+		return pipe(Effect.promise(() => highlighter.loadLanguage(...wanted)), Effect.when(() => wanted.length > 0));
+	};
+	/** 読み込めた言語だけを色付けする。知らない言語は null (色付けせず 1 行ずつのまま) にする。 */
+	const highlightWith = (highlighter) => {
+		const available = new Set(highlighter.getLoadedLanguages());
+		return (code, language) => pipe(Option.some(resolve(language)), Option.filter((lang) => !excluded.has(lang) && available.has(lang)), Option.map((lang) => highlighter.codeToHast(code, {
+			lang,
+			...themed,
+			transformers
+		})), Option.getOrNull);
+	};
+	return (source) => pipe(shiki, Effect.tap(loadLanguagesIn(source)), Effect.map(highlightWith), Effect.runPromise);
+};
+/** 利用者が渡した色付けをそのまま使う。 */
+const customHighlighter = (highlight) => async () => highlight;
+/**
+* 利用者の `renderOptions` に、統合が作った色付けを足す。色付けしない設定なら何も足さない。
+*/
+const renderOptionsWith = (renderOptions, highlight) => pipe(highlight, Option.match({
+	onNone: () => ({ ...renderOptions }),
+	onSome: (value) => ({
+		...renderOptions,
+		highlight: value
+	})
+}));
+//#endregion
+//#region src/lint.ts
+/**
+* lint.ts — ビルドの前に、サイトのページのリンク切れを調べる。
+*
+* 判定は `@cosense-toolbox/lsp` の `checkSite` をそのまま使う。エディタの診断と
+* `csn-lsp check` と同じ関数なので、エディタで警告されるものとビルドで止まるものが一致する。
+*/
+/** `path:line:column message`。path はプロジェクトのルートから。 */
+const messageOf = (root) => ({ path, line, column, message }) => `${relative(root, path).split(sep).join("/")}:${line}:${column} ${message}`;
+/**
+* `srcDir` の下の `.csn` / `.csnx` を読み、リンク切れを調べる。
+* パースにはサイトの `parseOptions` を使うので、独自の装飾記法もビルドと同じに読む。
+*/
+const lintSite = (root, srcDir, { unresolvedLinks = "warning", frontmatter = true }, parseOptions = {}) => Effect.map(checkSite({
+	roots: [srcDir],
+	unresolvedLinks,
+	parseOptions,
+	frontmatter
+}), (reports) => {
+	const [warnings, errors] = Array.partition(reports, ({ level }) => level === "error");
+	return {
+		errors: Array.map(errors, messageOf(root)),
+		warnings: Array.map(warnings, messageOf(root))
+	};
+});
+//#endregion
+//#region src/site.ts
+/**
+* site.ts — プロジェクトの `.csn` / `.csnx` を全部読み、索引とリンクグラフを作る。
+*
+* リンクの解決には全ページのタイトルが要るので、1 ファイルずつのコンパイルの前にまとめて読む。
+* パースは軽いので、全ページを先読みしても問題にならない。
+*/
+const EXTENSIONS = [".csn", ".csnx"];
+const isCosenseFile = (path) => EXTENSIONS.some((extension) => path.endsWith(extension));
+/** ルートからの相対パス (区切りは `/`)。Astro の content collection の `filePath` と同じ形。 */
+const idOf = (root, absolute) => relative(root, absolute).split(sep).join("/");
+const SKIP_DIRECTORIES = /* @__PURE__ */ new Set([
+	"node_modules",
+	".astro",
+	"dist"
+]);
+/** `directory` の下の `.csn` / `.csnx`。読めないディレクトリ (まだ無い src/content など) は空とみなす。 */
+const listFiles = async (directory) => {
+	const entries = await readdir(directory, { withFileTypes: true }).catch(() => []);
+	return (await Promise.all(entries.map(async (entry) => {
+		const path = join(directory, entry.name);
+		if (entry.isDirectory()) return SKIP_DIRECTORIES.has(entry.name) ? [] : listFiles(path);
+		return entry.isFile() && isCosenseFile(entry.name) ? [path] : [];
+	}))).flat().sort();
+};
+/** `directory` の下を読んで、索引とグラフを作る。id は `root` からの相対パス。 */
+const scanSite = async (root, directory, options = {}) => {
+	const files = await listFiles(directory);
+	const pages = (await Promise.all(files.map(async (file) => ({
+		id: idOf(root, file),
+		source: await readFile(file, "utf8")
+	})))).map(({ id, source }) => ({
+		id,
+		metadata: readPage(source, {
+			...options,
+			filePath: id
+		}).metadata
+	}));
+	return {
+		index: createIndex(pages.map(({ id, metadata }) => ({
+			id,
+			title: metadata.title,
+			slug: metadata.slug,
+			draft: metadata.draft
+		}))),
+		graph: buildGraph(pages)
+	};
+};
+const createSiteCache = (root, directory, options = {}) => {
+	let site;
+	return {
+		get: () => {
+			site ??= scanSite(root, directory, options);
+			return site;
+		},
+		reset: () => {
+			site = void 0;
+		}
+	};
+};
+//#endregion
+//#region src/vite-plugin.ts
+/**
+* vite-plugin.ts — `.csn` / `.csnx` を Astro のコンポーネントのモジュールにする。
+*/
+const GRAPH_MODULE_ID = "virtual:cosense-x/graph";
+const RESOLVED_GRAPH_MODULE_ID = `\0${GRAPH_MODULE_ID}`;
+const ASSETS_MODULE_ID = "virtual:cosense-x/assets";
+const RESOLVED_ASSETS_MODULE_ID = `\0${ASSETS_MODULE_ID}`;
+/**
+* `toHtml` などで自分で描画するページから、Cosense 上のファイルを置くための関数。
+* 置き場は統合が作って `globalThis` に置いたものを使う。ページの描画はビルドでも dev でも
+* 統合と同じプロセスで走るので、PAT をモジュールのコードに埋め込まずに済む。
+* 置き場が無いとき (実行時に描画する SSR など) は、元の URL のまま返す。
+*/
+const ASSETS_MODULE = `const store = () => globalThis[Symbol.for(${JSON.stringify(ASSET_STORE_KEY)})];
+export const cosenseAsset = (url) => store()?.resolve(url) ?? Promise.resolve(url);
+export const localizeCosenseAssets = (html) => store()?.localizeHtml(html) ?? Promise.resolve(html);
+`;
+/** dev サーバーで返す Content-Type。ビルドでは静的なホスティングが拡張子から決める。 */
+const CONTENT_TYPES$1 = {
+	".png": "image/png",
+	".jpg": "image/jpeg",
+	".gif": "image/gif",
+	".webp": "image/webp",
+	".avif": "image/avif",
+	".svg": "image/svg+xml",
+	".ico": "image/x-icon",
+	".pdf": "application/pdf",
+	".mp4": "video/mp4",
+	".mp3": "audio/mpeg"
+};
+/** 統合の compile の設定を、`compile` が受け取る形にする。 */
+const compileOptionsOf = ({ unresolvedLinks, ...rest }) => Option.match(Option.fromNullable(unresolvedLinks), {
+	onNone: () => rest,
+	onSome: (unresolved) => ({
+		...rest,
+		unresolved
+	})
+});
+/**
+* `@astrojs/mdx` と同じ形に整える。`Content` を default export にし、
+* Astro がそれを `astro:jsx` のコンポーネントとして描画できるよう印を付ける。
+*/
+const toAstroModule = (code, id, options) => {
+	const { components, layout, ssr } = options;
+	const content = layout === void 0 ? ["export const Content = (props = {}) => __cosenseBody(props);"] : [
+		`import __CosenseLayout from ${JSON.stringify(layout)};`,
+		"import { jsx as __cosenseJsx } from 'astro/jsx-runtime';",
+		"export const Content = (props = {}) => __cosenseJsx(__CosenseLayout, {",
+		"  file, frontmatter, metadata,",
+		"  children: __cosenseBody(props),",
+		"});"
+	];
+	const tag = ssr ? ["import { __astro_tag_component__ } from 'astro/runtime/server/index.js';", "__astro_tag_component__(Content, 'astro:jsx');"] : [];
+	return [
+		code.replace("export default function CosenseContent", "function CosenseContent"),
+		components === void 0 ? "const __cosenseComponents = {};" : `import __cosenseComponents from ${JSON.stringify(components)};`,
+		`export const file = ${JSON.stringify(id)};`,
+		"const __cosenseBody = (props) => CosenseContent({",
+		"  ...props,",
+		"  components: { ...__cosenseComponents, ...props.components },",
+		"});",
+		...content,
+		"export default Content;",
+		"Content[Symbol.for('mdx-component')] = true;",
+		`Content[Symbol.for('astro.needsHeadRendering')] = ${layout === void 0};`,
+		`Content.moduleId = ${JSON.stringify(id)};`,
+		...tag
+	].join("\n");
+};
+const vitePluginCosense = (options) => {
+	const root = fileURLToPath(options.root);
+	const loadSite = options.site.get;
+	return {
+		name: "@cosense-toolbox/astro",
+		enforce: "pre",
+		resolveId(id) {
+			if (id === "virtual:cosense-x/graph") return RESOLVED_GRAPH_MODULE_ID;
+			if (id === "virtual:cosense-x/assets") return RESOLVED_ASSETS_MODULE_ID;
+		},
+		async load(id) {
+			if (id === RESOLVED_ASSETS_MODULE_ID) return ASSETS_MODULE;
+			if (id !== RESOLVED_GRAPH_MODULE_ID) return void 0;
+			const { graph } = await loadSite();
+			return `export const graph = ${JSON.stringify(graph)};\nexport default graph;`;
+		},
+		transform: {
+			filter: { id: /\.csnx?$/ },
+			async handler(code, id) {
+				const { index } = await loadSite();
+				const highlight = Option.fromNullable(await options.highlighter?.(code));
+				const result = await compile(code, {
+					...compileOptionsOf(options.compile),
+					renderOptions: renderOptionsWith(options.compile.renderOptions, highlight),
+					filePath: idOf(root, id),
+					index,
+					jsxImportSource: "astro"
+				});
+				for (const warning of result.warnings) this.warn(warning);
+				const ssr = this.environment.name === "ssr" || this.environment.name === "prerender";
+				const layout = result.frontmatter.layout;
+				return {
+					code: toAstroModule(result.code, id, {
+						components: options.components,
+						layout: typeof layout === "string" ? layout : void 0,
+						ssr
+					}),
+					map: null
+				};
+			}
+		},
+		configureServer(server) {
+			const assets = options.assets;
+			if (assets !== void 0) server.middlewares.use(assets.publicPath, async (request, response, next) => {
+				const name = (() => {
+					try {
+						return decodeURIComponent(basename(request.url?.split("?")[0] ?? ""));
+					} catch {
+						return "";
+					}
+				})();
+				const file = join(assets.cacheDir, basename(name));
+				if (!await stat(file).then((s) => s.isFile()).catch(() => false)) {
+					next();
+					return;
+				}
+				const type = CONTENT_TYPES$1[extname(file)];
+				if (type !== void 0) response.setHeader("content-type", type);
+				createReadStream(file).pipe(response);
+			});
+			const onChange = (file) => {
+				if (!isCosenseFile(file)) return;
+				options.site.reset();
+				for (const environment of Object.values(server.environments)) {
+					const graph = environment.moduleGraph;
+					for (const [id, module] of graph.idToModuleMap) if (id === RESOLVED_GRAPH_MODULE_ID || isCosenseFile(id.split("?")[0] ?? "")) graph.invalidateModule(module);
+				}
+				server.ws.send({ type: "full-reload" });
+			};
+			server.watcher.on("add", onChange);
+			server.watcher.on("change", onChange);
+			server.watcher.on("unlink", onChange);
+		}
+	};
+};
+//#endregion
+//#region src/index.ts
+/**
+* `@cosense-toolbox/astro` — `.csn` / `.csnx` を Astro のページと content collection で使う。
+*
+* ```js
+* // astro.config.mjs
+* import cosense from '@cosense-toolbox/astro'
+* export default defineConfig({
+*   integrations: [cosense({ pageUrl: (page) => `/posts/${page.slug}` })],
+* })
+* ```
+*/
+/** サイトのリンク切れを調べ、見つかったものをログに出す。 */
+const reportLint = (config, lint, compileOptions, logger) => pipe(lintSite(fileURLToPath(config.root), fileURLToPath(config.srcDir), lint, compileOptions.parseOptions), Effect.tap(({ errors, warnings }) => Effect.all([Effect.forEach(warnings, (warning) => Effect.sync(() => logger.warn(warning))), Effect.forEach(errors, (error) => Effect.sync(() => logger.error(error)))])));
+/** ビルドでは、error があれば失敗してビルドを止める。 */
+const stopOnErrors = ({ errors }) => Array.match(errors, {
+	onEmpty: () => Effect.void,
+	onNonEmpty: (found) => Effect.fail(/* @__PURE__ */ new Error(`リンク切れが ${found.length} 件あるので、ビルドを止めた`))
+});
+/**
+* 開発中は止めずに知らせるだけにする。何も無いときも 1 行出して、調べたことが分かるようにする。
+*/
+const noteWhenClean = (logger) => ({ errors, warnings }) => Array.isEmptyReadonlyArray([...errors, ...warnings]) ? Effect.sync(() => logger.info("リンク切れは見つからなかった")) : Effect.void;
+/** `{base}/_cosense/`。base の末尾の `/` の有無を吸収する。 */
+const assetsPathOf = (config) => `${config.base.replace(/\/$/, "")}/_cosense/`;
+/** 静的なサイトでは出力先そのもの、サーバー出力ではクライアント向けの出力先に置く。 */
+const assetsDirOf = (config, dir) => new URL("_cosense/", config.output === "static" ? dir : config.build.client);
+const CONTENT_TYPES = `declare module 'astro:content' {
+  interface Render {
+${EXTENSIONS.map((extension) => `  '${extension}': Promise<{ Content: import('astro').MDXContent }>;`).join("\n")}
+  }
+}
+`;
+const INJECTED_TYPES = `declare module '${GRAPH_MODULE_ID}' {
+  export const graph: import('@cosense-toolbox/cosense-x/graph').Graph;
+  export default graph;
+}
+declare module '${ASSETS_MODULE_ID}' {
+  /** Cosense 上のファイルなら、ビルド時に取ってきて置いたサイトの中の URL を返す。それ以外はそのまま返す */
+  export const cosenseAsset: (url: string) => Promise<string>;
+  /** HTML の src / href のうち、Cosense 上のファイルを指すものを差し替える (toHtml の出力に使う) */
+  export const localizeCosenseAssets: (html: string) => Promise<string>;
+}
+${EXTENSIONS.map((extension) => `
+declare module '*${extension}' {
+  export const frontmatter: Record<string, unknown>;
+  export const metadata: import('@cosense-toolbox/cosense-x').PageMetadata;
+  export const file: string;
+  export const Content: import('astro').MDXContent;
+  export default Content;
+}`).join("\n")}
+`;
+function cosense(options = {}) {
+	const { components, assets: assetsOptions = {}, syntaxHighlight = "astro", lint, ...compileOptions } = options;
+	let assets;
+	let astroConfig;
+	return {
+		name: "@cosense-toolbox/astro",
+		hooks: {
+			"astro:config:setup": (params) => {
+				const { addPageExtension, addContentEntryType } = params;
+				const { config, addRenderer, updateConfig, logger } = params;
+				const root = fileURLToPath(config.root);
+				assets = assetsOptions === false ? void 0 : createAssetStore({
+					cacheDir: fileURLToPath(new URL("cosense-assets/", config.cacheDir)),
+					publicPath: assetsPathOf(config),
+					fetchOptions: {
+						...assetsOptions.pat === void 0 ? {} : { pat: assetsOptions.pat },
+						...assetsOptions.origin === void 0 ? {} : { origin: assetsOptions.origin }
+					},
+					...assetsOptions.links === void 0 ? {} : { links: assetsOptions.links },
+					warn: (message) => logger.warn(message)
+				});
+				const highlighter = syntaxHighlight === false ? void 0 : syntaxHighlight === "astro" ? astroShikiHighlighter(config.markdown) : customHighlighter(syntaxHighlight);
+				Object.assign(globalThis, { [Symbol.for(ASSET_STORE_KEY)]: assets });
+				const site = createSiteCache(root, fileURLToPath(config.srcDir), options.parseOptions === void 0 ? {} : { parseOptions: options.parseOptions });
+				addRenderer({
+					name: "astro:jsx",
+					serverEntrypoint: new URL("./server.mjs", import.meta.url)
+				});
+				for (const extension of EXTENSIONS) addPageExtension(extension);
+				addContentEntryType({
+					extensions: [...EXTENSIONS],
+					async getEntryInfo({ fileUrl, contents }) {
+						const { frontmatter, metadata, body } = readPage(contents, {
+							filePath: idOf(root, fileURLToPath(fileUrl)),
+							...options.parseOptions === void 0 ? {} : { parseOptions: options.parseOptions }
+						});
+						const { links: _links, ...fields } = metadata;
+						return {
+							data: {
+								...frontmatter,
+								...fields
+							},
+							body,
+							slug: metadata.slug,
+							rawData: ""
+						};
+					},
+					contentModuleTypes: CONTENT_TYPES,
+					handlePropagation: true
+				});
+				updateConfig({ vite: { plugins: [vitePluginCosense({
+					root: config.root,
+					site,
+					compile: assets === void 0 ? compileOptions : {
+						...compileOptions,
+						rehypePlugins: [...compileOptions.rehypePlugins ?? [], rehypeCosenseAssets(assets)]
+					},
+					assets,
+					highlighter,
+					components: components === void 0 ? void 0 : fileURLToPath(new URL(components, config.root))
+				})] } });
+			},
+			"astro:config:done": ({ config, injectTypes }) => {
+				astroConfig = config;
+				injectTypes({
+					filename: "types.d.ts",
+					content: INJECTED_TYPES
+				});
+			},
+			"astro:build:start": async ({ logger }) => {
+				if (lint === void 0 || astroConfig === void 0) return;
+				await Effect.runPromise(Effect.flatMap(reportLint(astroConfig, lint, compileOptions, logger), stopOnErrors));
+			},
+			"astro:server:setup": ({ server, logger }) => {
+				if (lint === void 0 || astroConfig === void 0) return;
+				const config = astroConfig;
+				const check = () => Effect.runFork(Effect.flatMap(reportLint(config, lint, compileOptions, logger), noteWhenClean(logger)));
+				const onChange = (file) => {
+					if (isCosenseFile(file)) check();
+				};
+				server.watcher.on("add", onChange);
+				server.watcher.on("change", onChange);
+				server.watcher.on("unlink", onChange);
+				check();
+			},
+			"astro:build:done": async ({ dir }) => {
+				if (assets === void 0 || astroConfig === void 0) return;
+				await assets.copyUsedTo(assetsDirOf(astroConfig, dir));
+			}
+		}
+	};
+}
+//#endregion
+export { cosense as default };
+
+//# sourceMappingURL=index.mjs.map