@segnavia/html 0.39.0 → 0.40.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { base64ToBytes, bytesToBase64 } from "./base64.js";
-import { REFUSED_ELEMENTS, SanitizeOptions, findActiveContent, safeImageSource, sanitize } from "./sanitize.js";
+import { REFUSED_ELEMENTS, SanitizeOptions, UrlPolicy, findActiveContent, safeImageSource, safeMarkdownUrl, sanitize } from "./sanitize.js";
 import { BINDINGS, FillOptions, Filled, bindingNames, bindingRoot, fill, hasBindings } from "./bindings.js";
 import { BookBuild, BookDocument, BookDocumentOptions, BookHeading, BookPrintPart, BookSectionInfo, bookPrintPart } from "./book/types.js";
 import { BOOK_COLUMN_MAX, BOOK_COLUMN_MIN, BOOK_FLOW_COLUMN_MIN_PX, BookPositionKey, parseBookPositionKey } from "./book/book-flow.js";
@@ -16,6 +16,7 @@ import { bookStylesheet, sanitizeBookCss } from "./book-css.js";
 import { FontCssRefusedError, fontCss, fontFaceCss } from "./font-css.js";
 import { fontFormat } from "./font-format.js";
 import { fontReferenceRefusals } from "./font-references.js";
+import { AlertKind, AlertLabels, BodyHtmlOptions, HtmlPage, MarkdownHeading, alertLabels, bodyHtml, isDiagramFence, isGithubAlertBlock, markdownOutline, resolvePageHtml } from "./markdown.js";
 import { ExpandMotifsOptions, ExpandedMotifs, MOTIF_DEPTH_LIMIT, MotifRefusedError, PlacedMotif, documentLanguage, expandMotifs, hasHostMotifPlacement, hasMotifPlacement, libraryMotifPlacementRefusal, motifPlacementRefusals, renderMotifPlacements } from "./motifs.js";
 import { MediaAnswer, PLACEMENT_ATTRIBUTES, PlacementPlan, PlacementPlanEntry, PlacementRefusal, PlacementReport, PlacementsOptions, ResolvePlacement, ResolvedPlacement, classifyMediaAnswer, placementCropEdges, placementPlaceholderSource, placementPlan, resolvePlacements } from "./placements.js";
 import { SlotFillEntry, SlotFillRefusal, SlotFillsConflictError, SlotFillsRefusedError, SlotPrintOptions, assertSingleSlotCopy, assertSlotPrintOptions, collectSlotPrintCopies, isSlotCopyRefusal, slotFillCopyId, slotFillsConflict } from "./slot-print.js";
@@ -27,4 +28,4 @@ export type HtmlKind = 'plain' | 'live-data' | 'scripted' | 'refused';
 export declare function classify(html: string, prefix: string): HtmlKind;
 export declare function searchText(html: string): string;
 //#endregion
-export { ABSOLUTE_PX, ABSOLUTE_UNITS, BINDINGS, BOOK_COLUMN_MAX, BOOK_COLUMN_MIN, BOOK_FLOW_COLUMN_MIN_PX, type BookBuild, type BookDocument, type BookDocumentOptions, type BookFurnitureValues, type BookHeading, BookPageFacts, type BookPositionKey, type BookPrintPart, BookPrintedPagePlan, BookPrintedPageRole, type BookSectionInfo, type BookSectionParents, type ExpandMotifsOptions, type ExpandedMotifs, type FillOptions, type Filled, FontCssRefusedError, MAX_SLOT_DECLARATIONS, MOTIF_DEPTH_LIMIT, type MediaAnswer, MotifRefusedError, PAGE_REFERENCE_ATTRIBUTE, PAGE_REFERENCE_SELECTOR, PAGE_REFERENCE_VALUE, PAGINATE_FUNCTIONS, PLACEMENT_ATTRIBUTES, type PaginateBlock, type PaginateBookInput, type PaginateBookPage, type PaginateBookRefusal, type PaginateBookResult, type PaginateFlow, type PaginateFlowParents, type PaginateLine, type PaginateMark, type PaginateNote, type PaginateNoteRef, type PaginateNoteSeriesGeometry, type PaginateOpens, type PaginatePageMarks, type PaginatePageNote, type PaginatePageRole, type PaginateSequence, type PaginateTarget, type PaginateTargetPage, type PaginateWindow, type PlacedMotif, type PlacementPlan, type PlacementPlanEntry, type PlacementRefusal, type PlacementReport, type PlacementsOptions, type PreparedSlots, PrintedPagePlan, PrintedPageSide, REFUSED_ELEMENTS, RequiredSlotsRefusedError, type ResolvePlacement, type ResolvedPlacement, type SanitizeOptions, type SlotFillEntry, type SlotFillRefusal, SlotFillRefusedError, SlotFillsConflictError, SlotFillsRefusedError, type SlotPrintOptions, UNICODE_RANGE_CLEARANCE, type UnicodeRangeParse, UnmeasuredSlotsRefusedError, assertSingleSlotCopy, assertSlotPrintOptions, base64ToBytes, bindingNames, bindingRoot, bookDocument, bookPrintPart, bookStylesheet, bookView, bookViewFromHtml, bytesToBase64, classifyMediaAnswer, collectSlotPrintCopies, documentLanguage, embedFunction, expandMotifs, fill, fillBookFurniture, findActiveContent, fitRegionSize, fontCss, fontFaceCss, fontFormat, fontReferenceRefusals, furnitureScript, hasBindings, hasHostMotifPlacement, hasMotifPlacement, hasSlotWork, heldPageNumber, isSlotCopyRefusal, lengthPx, libraryMotifPlacementRefusal, mergeSlotFitResults, motifPlacementRefusals, openerPageIndex, pageIndexForTarget, pageReferenceTarget, paginateBook, paginateScript, parseBookPositionKey, parseCssLength, parseUnicodeRange, placementCropEdges, placementPlaceholderSource, placementPlan, planBookPages, planPrintedPages, prepareSlotCollection, prepareSlots, printedPageAt, renderMotifPlacements, requiredSlotRefusal, resolvePlacements, safeImageSource, sanitize, sanitizeBookCss, selectBookParent, slotFillCopyId, slotFillRefusal, slotFillsConflict, unmeasuredSlotRefusal, windowPageIndex };
+export { ABSOLUTE_PX, ABSOLUTE_UNITS, type AlertKind, type AlertLabels, BINDINGS, BOOK_COLUMN_MAX, BOOK_COLUMN_MIN, BOOK_FLOW_COLUMN_MIN_PX, type BodyHtmlOptions, type BookBuild, type BookDocument, type BookDocumentOptions, type BookFurnitureValues, type BookHeading, BookPageFacts, type BookPositionKey, type BookPrintPart, BookPrintedPagePlan, BookPrintedPageRole, type BookSectionInfo, type BookSectionParents, type ExpandMotifsOptions, type ExpandedMotifs, type FillOptions, type Filled, FontCssRefusedError, type HtmlPage, MAX_SLOT_DECLARATIONS, MOTIF_DEPTH_LIMIT, type MarkdownHeading, type MediaAnswer, MotifRefusedError, PAGE_REFERENCE_ATTRIBUTE, PAGE_REFERENCE_SELECTOR, PAGE_REFERENCE_VALUE, PAGINATE_FUNCTIONS, PLACEMENT_ATTRIBUTES, type PaginateBlock, type PaginateBookInput, type PaginateBookPage, type PaginateBookRefusal, type PaginateBookResult, type PaginateFlow, type PaginateFlowParents, type PaginateLine, type PaginateMark, type PaginateNote, type PaginateNoteRef, type PaginateNoteSeriesGeometry, type PaginateOpens, type PaginatePageMarks, type PaginatePageNote, type PaginatePageRole, type PaginateSequence, type PaginateTarget, type PaginateTargetPage, type PaginateWindow, type PlacedMotif, type PlacementPlan, type PlacementPlanEntry, type PlacementRefusal, type PlacementReport, type PlacementsOptions, type PreparedSlots, PrintedPagePlan, PrintedPageSide, REFUSED_ELEMENTS, RequiredSlotsRefusedError, type ResolvePlacement, type ResolvedPlacement, type SanitizeOptions, type SlotFillEntry, type SlotFillRefusal, SlotFillRefusedError, SlotFillsConflictError, SlotFillsRefusedError, type SlotPrintOptions, UNICODE_RANGE_CLEARANCE, type UnicodeRangeParse, UnmeasuredSlotsRefusedError, type UrlPolicy, alertLabels, assertSingleSlotCopy, assertSlotPrintOptions, base64ToBytes, bindingNames, bindingRoot, bodyHtml, bookDocument, bookPrintPart, bookStylesheet, bookView, bookViewFromHtml, bytesToBase64, classifyMediaAnswer, collectSlotPrintCopies, documentLanguage, embedFunction, expandMotifs, fill, fillBookFurniture, findActiveContent, fitRegionSize, fontCss, fontFaceCss, fontFormat, fontReferenceRefusals, furnitureScript, hasBindings, hasHostMotifPlacement, hasMotifPlacement, hasSlotWork, heldPageNumber, isDiagramFence, isGithubAlertBlock, isSlotCopyRefusal, lengthPx, libraryMotifPlacementRefusal, markdownOutline, mergeSlotFitResults, motifPlacementRefusals, openerPageIndex, pageIndexForTarget, pageReferenceTarget, paginateBook, paginateScript, parseBookPositionKey, parseCssLength, parseUnicodeRange, placementCropEdges, placementPlaceholderSource, placementPlan, planBookPages, planPrintedPages, prepareSlotCollection, prepareSlots, printedPageAt, renderMotifPlacements, requiredSlotRefusal, resolvePageHtml, resolvePlacements, safeImageSource, safeMarkdownUrl, sanitize, sanitizeBookCss, selectBookParent, slotFillCopyId, slotFillRefusal, slotFillsConflict, unmeasuredSlotRefusal, windowPageIndex };

package/dist/index.js

@@ -1,4 +1,4 @@
-import { REFUSED_ELEMENTS, elements, findActiveContent, parse, safeImageSource, sanitize } from "./sanitize.js";
+import { REFUSED_ELEMENTS, elements, findActiveContent, parse, safeImageSource, safeMarkdownUrl, sanitize } from "./sanitize.js";
 import { BINDINGS, bindingNames, bindingRoot, fill, hasBindings } from "./bindings.js";
 import { base64ToBytes, bytesToBase64 } from "./base64.js";
 import { BOOK_COLUMN_MAX, BOOK_COLUMN_MIN, BOOK_FLOW_COLUMN_MIN_PX, parseBookPositionKey } from "./book/book-flow.js";
@@ -16,6 +16,7 @@ import { UNICODE_RANGE_CLEARANCE, parseUnicodeRange } from "./unicode-range.js";
 import { FontCssRefusedError, fontCss, fontFaceCss } from "./font-css.js";
 import { fontFormat } from "./font-format.js";
 import { fontReferenceRefusals } from "./font-references.js";
+import { alertLabels, bodyHtml, isDiagramFence, isGithubAlertBlock, markdownOutline, resolvePageHtml } from "./markdown.js";
 import { MOTIF_DEPTH_LIMIT, MotifRefusedError, documentLanguage, expandMotifs, hasHostMotifPlacement, hasMotifPlacement, libraryMotifPlacementRefusal, motifPlacementRefusals, renderMotifPlacements } from "./motifs.js";
 import { PLACEMENT_ATTRIBUTES, classifyMediaAnswer, placementCropEdges, placementPlaceholderSource, placementPlan, resolvePlacements } from "./placements.js";
 import { RequiredSlotsRefusedError, UnmeasuredSlotsRefusedError, mergeSlotFitResults, requiredSlotRefusal, unmeasuredSlotRefusal } from "./slot-policy.js";
@@ -33,4 +34,4 @@ function searchText(html) {
 	return html.replace(/<(script|style)\b[^>]*>[\s\S]*?<\/\1\s*>/gi, " ").replace(/<[^>]+>/g, " ").replace(/&nbsp;/g, " ").replace(/\s+/g, " ").trim();
 }
 //#endregion
-export { ABSOLUTE_PX, ABSOLUTE_UNITS, BINDINGS, BOOK_COLUMN_MAX, BOOK_COLUMN_MIN, BOOK_FLOW_COLUMN_MIN_PX, FontCssRefusedError, MAX_SLOT_DECLARATIONS, MOTIF_DEPTH_LIMIT, MotifRefusedError, PAGE_REFERENCE_ATTRIBUTE, PAGE_REFERENCE_SELECTOR, PAGE_REFERENCE_VALUE, PAGINATE_FUNCTIONS, PLACEMENT_ATTRIBUTES, REFUSED_ELEMENTS, RequiredSlotsRefusedError, SlotFillRefusedError, SlotFillsConflictError, SlotFillsRefusedError, UNICODE_RANGE_CLEARANCE, UnmeasuredSlotsRefusedError, assertSingleSlotCopy, assertSlotPrintOptions, base64ToBytes, bindingNames, bindingRoot, bookDocument, bookPrintPart, bookStylesheet, bookView, bookViewFromHtml, bytesToBase64, classify, classifyMediaAnswer, collectSlotPrintCopies, documentLanguage, embedFunction, expandMotifs, fill, fillBookFurniture, findActiveContent, fitRegionSize, fontCss, fontFaceCss, fontFormat, fontReferenceRefusals, furnitureScript, hasBindings, hasHostMotifPlacement, hasMotifPlacement, hasSlotWork, heldPageNumber, isSlotCopyRefusal, lengthPx, libraryMotifPlacementRefusal, mergeSlotFitResults, motifPlacementRefusals, openerPageIndex, pageIndexForTarget, pageReferenceTarget, paginateBook, paginateScript, parseBookPositionKey, parseCssLength, parseUnicodeRange, placementCropEdges, placementPlaceholderSource, placementPlan, planBookPages, planPrintedPages, prepareSlotCollection, prepareSlots, printedPageAt, renderMotifPlacements, requiredSlotRefusal, resolvePlacements, safeImageSource, sanitize, sanitizeBookCss, searchText, selectBookParent, slotFillCopyId, slotFillRefusal, slotFillsConflict, unmeasuredSlotRefusal, windowPageIndex };
+export { ABSOLUTE_PX, ABSOLUTE_UNITS, BINDINGS, BOOK_COLUMN_MAX, BOOK_COLUMN_MIN, BOOK_FLOW_COLUMN_MIN_PX, FontCssRefusedError, MAX_SLOT_DECLARATIONS, MOTIF_DEPTH_LIMIT, MotifRefusedError, PAGE_REFERENCE_ATTRIBUTE, PAGE_REFERENCE_SELECTOR, PAGE_REFERENCE_VALUE, PAGINATE_FUNCTIONS, PLACEMENT_ATTRIBUTES, REFUSED_ELEMENTS, RequiredSlotsRefusedError, SlotFillRefusedError, SlotFillsConflictError, SlotFillsRefusedError, UNICODE_RANGE_CLEARANCE, UnmeasuredSlotsRefusedError, alertLabels, assertSingleSlotCopy, assertSlotPrintOptions, base64ToBytes, bindingNames, bindingRoot, bodyHtml, bookDocument, bookPrintPart, bookStylesheet, bookView, bookViewFromHtml, bytesToBase64, classify, classifyMediaAnswer, collectSlotPrintCopies, documentLanguage, embedFunction, expandMotifs, fill, fillBookFurniture, findActiveContent, fitRegionSize, fontCss, fontFaceCss, fontFormat, fontReferenceRefusals, furnitureScript, hasBindings, hasHostMotifPlacement, hasMotifPlacement, hasSlotWork, heldPageNumber, isDiagramFence, isGithubAlertBlock, isSlotCopyRefusal, lengthPx, libraryMotifPlacementRefusal, markdownOutline, mergeSlotFitResults, motifPlacementRefusals, openerPageIndex, pageIndexForTarget, pageReferenceTarget, paginateBook, paginateScript, parseBookPositionKey, parseCssLength, parseUnicodeRange, placementCropEdges, placementPlaceholderSource, placementPlan, planBookPages, planPrintedPages, prepareSlotCollection, prepareSlots, printedPageAt, renderMotifPlacements, requiredSlotRefusal, resolvePageHtml, resolvePlacements, safeImageSource, safeMarkdownUrl, sanitize, sanitizeBookCss, searchText, selectBookParent, slotFillCopyId, slotFillRefusal, slotFillsConflict, unmeasuredSlotRefusal, windowPageIndex };

package/dist/markdown-policy.js

@@ -0,0 +1,20 @@
+//#region src/markdown-policy.ts
+const MARKDOWN_CONVERTER_POLICY = {
+	urls: {
+		linkProtocols: [
+			"https:",
+			"http:",
+			"mailto:"
+		],
+		imageProtocols: ["https:", "http:"],
+		linkFragments: true,
+		dataImages: true
+	},
+	inertControls: [{
+		element: "input",
+		type: "checkbox",
+		attribute: "disabled"
+	}]
+};
+//#endregion
+export { MARKDOWN_CONVERTER_POLICY };

package/dist/markdown.d.ts

@@ -0,0 +1,29 @@
+import { Page, PageBody } from "@segnavia/format";
+//#region src/markdown.d.ts
+export type MarkdownHeading = {
+  id: string;
+  level: number;
+  title: string;
+};
+export type AlertKind = 'note' | 'tip' | 'important' | 'warning' | 'caution';
+export type AlertLabels = Record<AlertKind, string>;
+export declare const alertLabels: Readonly<Record<'en' | 'he', AlertLabels>>;
+/** Whether the reader recognizes a blockquote source as a GitHub alert. */
+export declare function isGithubAlertBlock(raw: string): boolean;
+/** Whether the reader turns a fenced language into a diagram placeholder. */
+export declare function isDiagramFence(language: string | undefined): boolean;
+export interface BodyHtmlOptions {
+  alertLabels?: Partial<AlertLabels>;
+  dir?: 'ltr' | 'rtl' | 'auto';
+  lang?: string;
+}
+export declare function bodyHtml(body: PageBody, options?: BodyHtmlOptions): string;
+export declare function markdownOutline(markdown: string | Extract<PageBody, {
+  markdown: string;
+}>): MarkdownHeading[];
+export type HtmlPage = Omit<Page, 'body'> & {
+  html: string;
+};
+export declare function resolvePageHtml(page: Page, options: Pick<BodyHtmlOptions, 'alertLabels'>): HtmlPage;
+export declare function resolvePageHtml(page: Page): HtmlPage;
+//#endregion

package/dist/markdown.js

@@ -0,0 +1,278 @@
+import { MARKDOWN_CONVERTER_POLICY } from "./markdown-policy.js";
+import { sanitize } from "./sanitize.js";
+import { resolveDirection } from "@segnavia/format";
+import rehypeStringify from "rehype-stringify";
+import remarkDirective from "remark-directive";
+import remarkFrontmatter from "remark-frontmatter";
+import remarkGfm from "remark-gfm";
+import remarkParse from "remark-parse";
+import remarkRehype from "remark-rehype";
+import { unified } from "unified";
+import { parse } from "yaml";
+//#region src/markdown.ts
+const alertLabels = {
+	en: {
+		note: "Note",
+		tip: "Tip",
+		important: "Important",
+		warning: "Warning",
+		caution: "Caution"
+	},
+	he: {
+		note: "הערה",
+		tip: "עצה",
+		important: "חשוב",
+		warning: "אזהרה",
+		caution: "זהירות"
+	}
+};
+function alertMarker(value) {
+	const match = /^\[!([A-Za-z]+)\](?:\r?\n|\s*)/.exec(value);
+	const kind = match?.[1]?.toLowerCase();
+	return kind && match && Object.hasOwn(alertLabels.en, kind) ? {
+		kind,
+		length: match[0].length
+	} : void 0;
+}
+/** Whether the reader recognizes a blockquote source as a GitHub alert. */
+function isGithubAlertBlock(raw) {
+	const content = raw.split("\n").map((line) => /^ {0,3}>[ \t]?(.*)$/.exec(line)?.[1] ?? "").find((line) => line.trim() !== "");
+	return Boolean(content && alertMarker(content));
+}
+/** Whether the reader turns a fenced language into a diagram placeholder. */
+function isDiagramFence(language) {
+	return (language ?? "").trim().split(/[ \t]/, 1)[0]?.toLowerCase() === "mermaid";
+}
+const GEOMETRY_STYLE = "<style>:where([data-segnavia-overflow]){max-inline-size:100%;overflow-x:auto}:where([data-segnavia-overflow]>table){inline-size:max-content;min-inline-size:100%}@media print{:where([data-segnavia-overflow]){overflow-x:visible}:where([data-segnavia-overflow]>table){inline-size:100%;max-inline-size:100%;min-inline-size:0}:where([data-segnavia-overflow]>pre){white-space:pre-wrap}}</style>";
+const memo = /* @__PURE__ */ new WeakMap();
+function textNode(value) {
+	return {
+		type: "text",
+		value
+	};
+}
+function element(tagName, children, properties) {
+	return {
+		type: "element",
+		tagName,
+		properties,
+		children
+	};
+}
+function propertyValue(value, ancestors) {
+	if (typeof value === "boolean") return [textNode(value ? "yes" : "no")];
+	if (Array.isArray(value)) {
+		if (ancestors.has(value)) return [textNode("(cycle)")];
+		const next = new Set(ancestors).add(value);
+		return value.flatMap((item) => [element("span", propertyValue(item, next))]);
+	}
+	if (value !== null && typeof value === "object") {
+		if (ancestors.has(value)) return [textNode("(cycle)")];
+		return [propertyList(value, new Set(ancestors).add(value))];
+	}
+	return [textNode(value == null ? "" : String(value))];
+}
+function propertyList(properties, ancestors) {
+	return element("dl", Object.entries(properties).flatMap(([key, value]) => [element("dt", [textNode(key)]), element("dd", propertyValue(value, ancestors))]));
+}
+function unreadableFrontmatter(source) {
+	return [element("p", [textNode("Frontmatter could not be read.")]), element("pre", [element("code", [textNode(`---\n${source}\n---`)])])];
+}
+function frontmatter(source) {
+	let value;
+	try {
+		value = parse(source);
+	} catch {
+		return unreadableFrontmatter(source);
+	}
+	if (value == null) return [];
+	if (typeof value !== "object" || Array.isArray(value)) return unreadableFrontmatter(source);
+	const properties = value;
+	return Object.keys(properties).length === 0 ? [] : propertyList(properties, /* @__PURE__ */ new Set([properties])).children ?? [];
+}
+function visibleText(node) {
+	if (node.type === "text" || node.type === "inlineCode") return node.value ?? "";
+	return (node.children ?? []).map(visibleText).join("");
+}
+function slug(title) {
+	return title.trim().toLowerCase().replace(/[^\p{L}\p{N}]+/gu, "-").replace(/^-+|-+$/g, "") || "section";
+}
+function directiveSource(node, source) {
+	const start = node.position?.start.offset;
+	const end = node.position && "end" in node.position ? node.position.end?.offset : void 0;
+	return start === void 0 || end === void 0 ? `:${node.name ?? ""}` : source.slice(start, end);
+}
+function applyFrontmatter(node) {
+	if (node.type !== "yaml" || typeof node.value !== "string") return;
+	node.type = "paragraph";
+	node.children = [];
+	node.data = {
+		hName: "dl",
+		hProperties: { dataSegnaviaFrontmatter: "" },
+		hChildren: frontmatter(node.value)
+	};
+}
+function applyHeading(node, seen, outline) {
+	if (node.type !== "heading" || !node.depth) return;
+	const title = visibleText(node);
+	const base = slug(title);
+	const count = seen.get(base) ?? 0;
+	seen.set(base, count + 1);
+	const id = count === 0 ? base : `${base}-${count + 1}`;
+	node.data = {
+		...node.data,
+		hProperties: {
+			...node.data?.hProperties,
+			id
+		}
+	};
+	outline.push({
+		id,
+		level: node.depth,
+		title
+	});
+}
+function applyDirective(node) {
+	if (node.type !== "containerDirective") return;
+	const attributes = Object.fromEntries(Object.entries(node.attributes ?? {}).map(([name, value]) => [`dataSegnaviaDirective${name.charAt(0).toUpperCase()}${name.slice(1).replace(/[^a-zA-Z0-9]+(.)/g, (_, next) => next.toUpperCase())}`, value ?? ""]));
+	node.data = {
+		hName: "div",
+		hProperties: {
+			dataSegnaviaDirective: node.name ?? "",
+			...attributes
+		}
+	};
+}
+function applyAlert(node, labels) {
+	if (node.type !== "blockquote") return;
+	const first = node.children?.[0]?.children?.find((child) => child.type === "text");
+	if (!first) return;
+	const marker = alertMarker(first.value ?? "");
+	if (!marker) return;
+	const { kind } = marker;
+	first.value = (first.value ?? "").slice(marker.length);
+	node.data = {
+		hName: "div",
+		hProperties: { dataSegnaviaAlert: kind }
+	};
+	node.children = [{
+		type: "paragraph",
+		children: [{
+			type: "text",
+			value: labels[kind]
+		}],
+		data: { hName: "bdi" }
+	}, ...node.children ?? []];
+}
+function literalDirectives(node, source) {
+	if (!node.children) return;
+	node.children = node.children.map((child) => child.type === "textDirective" || child.type === "leafDirective" ? {
+		type: "text",
+		value: directiveSource(child, source)
+	} : child);
+}
+function markdownPlugin(outline, labels) {
+	return (tree, file) => {
+		const source = String(file.value);
+		const seen = /* @__PURE__ */ new Map();
+		const visit = (node) => {
+			applyFrontmatter(node);
+			applyHeading(node, seen, outline);
+			applyDirective(node);
+			applyAlert(node, labels);
+			literalDirectives(node, source);
+			for (const child of node.children ?? []) visit(child);
+		};
+		visit(tree);
+	};
+}
+function alertLanguage(markdown, options) {
+	const primary = options.lang?.trim().toLowerCase().split(/[-_]/)[0];
+	if (primary === "en" || primary === "he") return primary;
+	const text = markdown.replace(/^>\s*\[![A-Za-z]+\]\s*$/gm, "");
+	return resolveDirection(options.dir, options.lang, text) === "rtl" ? "he" : "en";
+}
+function hastPlugin() {
+	return (tree) => {
+		const wrap = (node) => {
+			const copy = {
+				...node,
+				children: node.children
+			};
+			node.tagName = "div";
+			node.properties = { dataSegnaviaOverflow: "" };
+			node.children = [copy];
+		};
+		const transform = (node) => {
+			if (node.type !== "element") return;
+			if (node.tagName === "table") wrap(node);
+			if (node.tagName !== "pre") return;
+			const code = node.children?.[0];
+			if ((Array.isArray(code?.properties?.className) ? code.properties.className.map(String) : []).some((name) => name.startsWith("language-") && isDiagramFence(name.slice(9)))) node.properties = {
+				...node.properties,
+				dataSegnaviaDiagram: "mermaid"
+			};
+			else wrap(node);
+		};
+		const visit = (node) => {
+			for (const child of node.children ?? []) visit(child);
+			transform(node);
+		};
+		visit(tree);
+	};
+}
+function convert(markdown, options) {
+	const outline = [];
+	const language = alertLanguage(markdown, options);
+	const labels = {
+		...alertLabels[language],
+		...options.alertLabels
+	};
+	const result = unified().use(remarkParse).use(remarkGfm).use(remarkFrontmatter).use(remarkDirective).use(markdownPlugin, outline, labels).use(remarkRehype).use(hastPlugin).use(rehypeStringify).processSync(markdown);
+	return {
+		html: `${GEOMETRY_STYLE}${sanitize(String(result), { converterPolicy: MARKDOWN_CONVERTER_POLICY })}`,
+		outline
+	};
+}
+function optionKey(options) {
+	return JSON.stringify([
+		options.dir,
+		options.lang,
+		options.alertLabels
+	]);
+}
+function markdownResult(body, options) {
+	let entries = memo.get(body);
+	if (!entries) {
+		entries = /* @__PURE__ */ new Map();
+		memo.set(body, entries);
+	}
+	const key = optionKey(options);
+	const found = entries.get(key);
+	if (found !== void 0) return found;
+	const result = convert(body.markdown, options);
+	entries.set(key, result);
+	return result;
+}
+function outlinedMarkdownResult(body) {
+	return memo.get(body)?.values().next().value ?? markdownResult(body, {});
+}
+function bodyHtml(body, options = {}) {
+	return "html" in body ? body.html : markdownResult(body, options).html;
+}
+function markdownOutline(markdown) {
+	return outlinedMarkdownResult(typeof markdown === "string" ? { markdown } : markdown).outline;
+}
+function resolvePageHtml(page, options = {}) {
+	const { body, ...fields } = page;
+	return {
+		...fields,
+		html: bodyHtml(body, {
+			dir: page.dir,
+			lang: page.lang,
+			alertLabels: options.alertLabels
+		})
+	};
+}
+//#endregion
+export { alertLabels, bodyHtml, isDiagramFence, isGithubAlertBlock, markdownOutline, resolvePageHtml };

package/dist/sanitize.d.ts

@@ -7,8 +7,25 @@ export interface SanitizeOptions {
   dependencyOrigins?: Iterable<string>;
   dataFonts?: boolean;
   refuseElements?: Iterable<string>;
+  converterPolicy?: ConverterPolicy;
+}
+export interface UrlPolicy {
+  linkProtocols: readonly string[];
+  imageProtocols: readonly string[];
+  linkFragments: boolean;
+  dataImages: boolean;
+}
+export interface ConverterPolicy {
+  urls: UrlPolicy;
+  inertControls: readonly {
+    element: 'input';
+    type: 'checkbox';
+    attribute: 'disabled';
+  }[];
 }
 export declare function safeImageSource(value: string): boolean;
+/** The URL decision used when schema-based authoring admits a link or image. */
+export declare function safeMarkdownUrl(attribute: 'href' | 'src', value: string, linkOrigins?: Iterable<string>): boolean;
 export declare function findActiveContent(html: string, options?: SanitizeOptions): string[];
 export declare function sanitize(html: string, options?: SanitizeOptions): string;
 //#endregion

package/dist/sanitize.js

@@ -1,3 +1,4 @@
+import { MARKDOWN_CONVERTER_POLICY } from "./markdown-policy.js";
 import { sanitizeCss } from "./sanitize-css.js";
 import { isTag } from "domhandler";
 import { dependencyDecision, dependencyOriginSet, originSet } from "@segnavia/format";
@@ -83,25 +84,47 @@ function normalizeUrl(value) {
 function safeImageSource(value) {
 	return DATA_IMAGE.test(normalizeUrl(value));
 }
-function safeUrl(attribute, value, allowed) {
+function safeUrl(attribute, value, allowed, policy) {
 	const url = normalizeUrl(value);
 	if (attribute === "href" || attribute === "xlink:href") {
-		if (url.startsWith("#")) return true;
+		if (url.startsWith("#")) return policy?.linkFragments ?? true;
 		try {
 			const parsed = new URL(url);
+			if (policy) return policy.linkProtocols.includes(parsed.protocol);
 			return parsed.protocol === "https:" && allowed.has(parsed.origin);
 		} catch {
 			return false;
 		}
 	}
 	if (attribute === "srcset") return DATA_IMAGE_SRCSET.test(url);
-	if (attribute === "src" || attribute === "poster") return safeImageSource(value);
+	if (attribute === "src" || attribute === "poster") {
+		if (policy?.dataImages && safeImageSource(value)) return true;
+		if (!policy) return safeImageSource(value);
+		try {
+			return policy.imageProtocols.includes(new URL(url).protocol);
+		} catch {
+			return false;
+		}
+	}
 	return false;
 }
-function refusedElement(element, refused, keepScripts) {
+/** The URL decision used when schema-based authoring admits a link or image. */
+function safeMarkdownUrl(attribute, value, linkOrigins) {
+	if (!safeUrl(attribute, value, /* @__PURE__ */ new Set(), MARKDOWN_CONVERTER_POLICY.urls)) return false;
+	if (attribute === "src" || linkOrigins === void 0 || value.startsWith("#")) return true;
+	let parsed;
+	try {
+		parsed = new URL(value);
+	} catch {
+		return true;
+	}
+	return parsed.protocol !== "http:" && parsed.protocol !== "https:" || originSet(linkOrigins).has(parsed.origin.toLowerCase());
+}
+function refusedElement(element, refused, options, keepScripts) {
 	const name = element.name.toLowerCase();
 	if (name === "script") return !keepScripts;
 	if (name === "link" && keepScripts && element.attribs.rel?.toLowerCase() === "stylesheet") return false;
+	if (options.converterPolicy?.inertControls.some((control) => control.element === name && element.attribs.type?.toLowerCase() === control.type && control.attribute in element.attribs)) return false;
 	if (refused.has(name)) return true;
 	if (insideSvg(element) && REFUSED_SVG_ELEMENTS.has(name)) return true;
 	return name === "meta" && Object.keys(element.attribs).some((attribute) => attribute.toLowerCase() === "http-equiv");
@@ -118,7 +141,7 @@ function refusedAttribute(element, name, value, allowed, options, dependencies)
 	if (attribute.startsWith("on")) return options.keepScripts ? void 0 : "";
 	const dependency = dependencyAttribute(element, attribute, value, options, dependencies);
 	if (dependency !== void 0) return dependency || void 0;
-	return REFUSED_ATTRIBUTES.has(attribute) || URL_ATTRIBUTES.has(attribute) && !safeUrl(attribute, value, allowed) ? "" : void 0;
+	return REFUSED_ATTRIBUTES.has(attribute) || URL_ATTRIBUTES.has(attribute) && !safeUrl(attribute, value, allowed, options.converterPolicy?.urls) ? "" : void 0;
 }
 function refusedSet(options) {
 	const defaults = options.keepScripts ? Object.entries(REFUSED).filter(([, rule]) => rule === "always").map(([name]) => name) : REFUSED_ELEMENTS;
@@ -168,7 +191,7 @@ function findActiveContent(html, options = {}) {
 	const keepScripts = options.keepScripts ?? false;
 	const found = [];
 	for (const element of elements(parse(html).children)) {
-		if (refusedElement(element, refused, keepScripts)) found.push(`<${element.name}>`);
+		if (refusedElement(element, refused, options, keepScripts)) found.push(`<${element.name}>`);
 		found.push(...styleFindings(element, options, dependencies));
 		for (const [name, value] of Object.entries(element.attribs)) {
 			const reason = refusedAttribute(element, name, value, allowed, options, dependencies);
@@ -201,7 +224,7 @@ function sanitize(html, options = {}) {
 	const document = parse(html);
 	const prune = (nodes) => nodes.filter((node) => {
 		if (!isTag(node)) return true;
-		if (refusedElement(node, refused, keepScripts)) return false;
+		if (refusedElement(node, refused, options, keepScripts)) return false;
 		cleanStyleElement(node, options, dependencies);
 		cleanAttributes(node, allowed, options, dependencies);
 		node.children = prune(node.children);
@@ -211,4 +234,4 @@ function sanitize(html, options = {}) {
 	return serialize(document);
 }
 //#endregion
-export { REFUSED_ELEMENTS, elements, findActiveContent, parse, safeImageSource, sanitize, serialize };
+export { REFUSED_ELEMENTS, elements, findActiveContent, parse, safeImageSource, safeMarkdownUrl, sanitize, serialize };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@segnavia/html",
-  "version": "0.39.0",
+  "version": "0.40.0",
   "type": "module",
   "license": "MIT",
   "repository": {
@@ -26,10 +26,18 @@
     }
   },
   "dependencies": {
-    "@segnavia/format": "0.39.0",
+    "@segnavia/format": "0.40.0",
     "dom-serializer": "^2.0.0",
     "domhandler": "^5.0.3",
     "htmlparser2": "^10.0.0",
-    "qrcode-generator": "2.0.4"
+    "qrcode-generator": "2.0.4",
+    "rehype-stringify": "10.0.1",
+    "remark-directive": "4.0.0",
+    "remark-frontmatter": "5.0.0",
+    "remark-gfm": "4.0.1",
+    "remark-parse": "11.0.0",
+    "remark-rehype": "11.1.2",
+    "unified": "11.0.5",
+    "yaml": "2.9.1"
   }
 }