@topik/content 0.1.0-alpha.6 → 0.1.0-alpha.7

package/dist/index.d.mts

@@ -1,5 +1,4 @@
 import { Code, Node, Root, RootContent } from "mdast";
-//#region src/expressions.d.ts
 /** The deliberately small expression language accepted in authored conditionals. */
 type Expression = {
   type: "literal";
@@ -12,8 +11,6 @@ type Expression = {
   name: "equals" | "and" | "or" | "not";
   args: Expression[];
 };
-//#endregion
-//#region src/code-presentation.d.ts
 /** Bounds are independent of ordinary, unpresented code admission. */
 export declare const CODE_PRESENTATION_LIMITS: Readonly<{
   metadataLength: 16384;
@@ -42,8 +39,6 @@ interface CodePresentationEffectiveOptions extends CodePresentationOptions {
   wrap: boolean;
 }
 export declare function effectiveCodePresentationOptions(options: CodePresentationOptions): CodePresentationEffectiveOptions;
-//#endregion
-//#region src/model.d.ts
 type Scalar = string | number | boolean;
 /** Unevaluated text with an explicit distinction between literals and references. */
 type TextTemplate = {
@@ -131,8 +126,6 @@ type ParseResult = {
   diagnostics: Diagnostic[];
   source: string;
 };
-//#endregion
-//#region src/extensions/native.d.ts
 declare const nativeComponents: {
   readonly codeBlock: {
     readonly name: "codeBlock";
@@ -237,8 +230,6 @@ declare const nativeComponents: {
     readonly description: "A header cell inside a Markdown table.";
   };
 };
-//#endregion
-//#region src/registry.d.ts
 export declare const TOPIK_CONTENT_SCHEMA_VERSION = "0.2.2";
 export declare const CALLOUT_VARIANTS: readonly ["info", "tip", "warning", "danger"];
 export declare const BADGE_VARIANTS: readonly ["neutral", "info", "success", "warning", "danger"];
@@ -363,41 +354,25 @@ export declare const topikComponents: Record<keyof typeof authoredComponents | k
 type TopikComponentName = keyof typeof topikComponents;
 /** Defaults are for reading/rendering; authored absence stays unchanged. */
 export declare function getEffectiveProps(component: Pick<Component, "name" | "props">, registry?: Registry): Record<string, AuthoredAttributeValue>;
-//#endregion
-//#region src/validation.d.ts
 export declare function validateDocument(document: ContentDocument, registry?: Registry): Diagnostic[];
-//#endregion
-//#region src/document-meaning.d.ts
 /** Compare admitted authoring trees, retaining explicit heading IDs and every authored branch.
  * Source positions, cosmetic spelling and derived metadata do not affect equality.
  * This compares meaning; it does not validate arbitrary caller-constructed trees.
  */
 export declare function sameDocumentMeaning(left: ContentDocument, right: ContentDocument): boolean;
-//#endregion
-//#region src/parser.d.ts
 export declare const FORMAT_VERSION = 1;
-//#endregion
-//#region src/writer.d.ts
 export declare function writeDocument(document: ContentDocument, registry?: Registry, formatVersion?: number): string;
-//#endregion
-//#region src/markdown.d.ts
 export declare function parseDocument(source: string, registry?: Registry, formatVersion?: number): ParseResult;
 export declare function formatDocument(source: string, registry?: Registry): ParseResult & {
   formatted?: string;
 };
-//#endregion
-//#region src/assets.d.ts
 /** Rewrite asset definitions once, preserving reference identity and unrelated navigation. */
 export declare function rewriteAssets(document: ContentDocument, replace: (url: string) => string | undefined, registry?: Registry): ContentDocument;
-//#endregion
-//#region src/evaluate.d.ts
 export declare class ContentEvaluationError extends Error {
   constructor(message: string);
 }
 /** Resolve into a new, writable document; the authored branches remain untouched. */
 export declare function evaluateDocument(document: ContentDocument, context: Record<string, unknown>, registry?: Registry): ContentDocument;
-//#endregion
-//#region src/limits.d.ts
 /** Fixed admission limits, measured in UTF-16 code units and tree nodes. */
 export declare const CONTENT_LIMITS: Readonly<{
   sourceLength: 1000000;
@@ -418,8 +393,6 @@ export declare class ContentLimitError extends Error {
   readonly id = "topik-content-limit";
   constructor(message: string);
 }
-//#endregion
-//#region src/config.d.ts
 interface TopikContentConfig {
   /** Additional component schemas. Canonical Topik definitions cannot be replaced. */
   components?: Record<string, ComponentSchema>;
@@ -432,8 +405,6 @@ interface ResolvedTopikContentConfig {
 }
 /** Isolate schemas before validation; runtime variables are read without invoking accessors. */
 export declare function mergeTopikContentConfig(extension?: TopikContentConfig): ResolvedTopikContentConfig;
-//#endregion
-//#region src/asset-reference-policy.d.ts
 export declare const TOPIK_ASSET_REFERENCE_VERSION: "topik-asset-reference-v1";
 /** Public grammar descriptor. Runtime admission uses an isolated boundary. */
 export declare const TOPIK_GENERATED_ASSET_NAME_PATTERN: RegExp;
@@ -462,8 +433,6 @@ type TopikAssetReferenceValidation = {
 };
 /** Validate the URL-facing portion of topik-asset-reference-v1 without filesystem access. */
 export declare function validateTopikAssetReference(reference: string): TopikAssetReferenceValidation;
-//#endregion
-//#region src/asset-references.d.ts
 interface TopikAssetReferenceSlot {
   node: "image" | "tag" | "link";
   tag?: "figure";
@@ -536,8 +505,6 @@ export declare function extractTopikAssetOccurrences(source: string, options?: E
 export declare function removeInvalidTopikAssetReferences(document: ContentDocument, source?: string, options?: {
   config?: TopikContentConfig;
 }): void;
-//#endregion
-//#region src/content.d.ts
 type TopikContentNode = ContentDocument;
 interface ParseTopikContentOptions {
   /** @deprecated Compatibility-only; use validation/analysis options for diagnostic labels. */
@@ -548,8 +515,6 @@ interface ParseTopikContentOptions {
 }
 /** Parse the authoring tree. Use validateTopikContent at publication boundaries. */
 export declare function parseTopikContent(source: string, options?: ParseTopikContentOptions): ContentDocument;
-//#endregion
-//#region src/diagnostics.d.ts
 type TopikContentDiagnosticLevel = "debug" | "info" | "warning" | "error" | "critical";
 interface ContentValidationIssue {
   type: string;
@@ -592,16 +557,12 @@ export declare function sanitizeTopikContentDiagnostic(diagnostic: TopikContentD
 export declare function toTopikContentDiagnostic(error: ContentValidationIssue): TopikContentDiagnostic;
 /** Convert an untrusted diagnostic location to a browser-compatible safe label. */
 export declare function sanitizeTopikDiagnosticFile(file: string | undefined): string | undefined;
-//#endregion
-//#region src/source.d.ts
 interface ValidateTopikContentOptions {
   file?: string;
   config?: TopikContentConfig;
   /** Accept compiler-produced references at a compiled-output boundary. */
   allowCompiledAssetReferences?: boolean;
 }
-//#endregion
-//#region src/validate.d.ts
 interface ValidateTopikContentResult {
   source: string;
   valid: boolean;
@@ -609,8 +570,6 @@ interface ValidateTopikContentResult {
 }
 /** Source admission is the same boundary used by formatting and asset rewriting. */
 export declare function validateTopikContent(source: string, options?: ValidateTopikContentOptions): ValidateTopikContentResult;
-//#endregion
-//#region src/format.d.ts
 interface FormatTopikContentOptions extends ValidateTopikContentOptions {}
 interface FormatTopikContentSuccess {
   ok: true;
@@ -628,8 +587,6 @@ interface FormatTopikContentFailure {
 type FormatTopikContentResult = FormatTopikContentSuccess | FormatTopikContentFailure;
 /** Validate source before formatting so unsupported input remains an exact opaque handoff. */
 export declare function formatTopikContent(source: string, options?: FormatTopikContentOptions): FormatTopikContentResult;
-//#endregion
-//#region src/rewrite.d.ts
 interface RewriteTopikAssetOccurrencesOptions extends ExtractTopikAssetOccurrencesOptions, ValidateTopikContentOptions {}
 interface RewriteTopikAssetOccurrencesSuccess {
   ok: true;
@@ -647,16 +604,12 @@ interface RewriteTopikAssetOccurrencesFailure {
 }
 type RewriteTopikAssetOccurrencesResult = RewriteTopikAssetOccurrencesSuccess | RewriteTopikAssetOccurrencesFailure;
 export declare function rewriteTopikAssetOccurrences(source: string, replace: (occurrence: TopikAssetOccurrence) => string | undefined, options?: RewriteTopikAssetOccurrencesOptions): RewriteTopikAssetOccurrencesResult;
-//#endregion
-//#region src/headings.d.ts
 interface TopikHeading {
   id: string;
   level: number;
   title: string;
 }
 export declare function assignTopikHeadingIds(document: ContentDocument): TopikHeading[];
-//#endregion
-//#region src/resource-references.d.ts
 /** Version of the portable compiled-content resource reference contract. */
 export declare const TOPIK_RESOURCE_REFERENCE_VERSION: 1;
 interface TopikResourceReference {
@@ -673,8 +626,6 @@ interface TopikResourceReference {
 export declare function parseTopikResourceReference(href: string): TopikResourceReference | null;
 /** Serialize an identity as a canonical ref:// URI; this is not a browser-facing URL. */
 export declare function serializeTopikResourceReference(reference: TopikResourceReference): string;
-//#endregion
-//#region src/navigation-rewrite.d.ts
 interface TopikNavigationReference {
   href: string;
   kind: "link" | "card";
@@ -694,8 +645,6 @@ type RewriteTopikNavigationResult = {
 };
 /** Rewrite actual navigation references, retaining definitions/scopes and every authored branch. */
 export declare function rewriteTopikNavigationReferences(source: string, replace: (reference: TopikNavigationReference) => string | undefined, options?: ValidateTopikContentOptions): RewriteTopikNavigationResult;
-//#endregion
-//#region src/links.d.ts
 type ValidationError = {
   id: string;
   level: "error";
@@ -728,8 +677,6 @@ export declare function validateTopikBrowserHref(value: unknown): ValidationErro
 export declare function validateTopikNavigationHref(value: unknown): ValidationError[];
 /** Remove invalid navigation attributes before a renderer can emit a browser-facing URL. */
 export declare function removeInvalidTopikNavigationReferences(root: ContentDocument): void;
-//#endregion
-//#region src/render.d.ts
 /** Framework-independent, serializable output. It contains no executable values. */
 type RenderableTreeNode = ContentTag | string | number | boolean | null | RenderableTreeNode[];
 export declare class ContentTag {
@@ -742,8 +689,6 @@ export declare class ContentTag {
 export declare function isContentTag(value: unknown): value is ContentTag;
 /** Render a validated authored document through a separate evaluated document. */
 export declare function transformTopikContent(document: ContentDocument, options?: TopikContentConfig): RenderableTreeNode;
-//#endregion
-//#region src/compiled.d.ts
 interface CompiledTopikContent {
   sourceFormat: "topik";
   topikSchemaVersion: string;
@@ -752,8 +697,6 @@ interface CompiledTopikContent {
   renderableTree: RenderableTreeNode;
   diagnostics: TopikContentDiagnostic[];
 }
-//#endregion
-//#region src/compile.d.ts
 interface CompileTopikContentOptions {
   file?: string;
   config?: TopikContentConfig;
@@ -775,9 +718,6 @@ interface CompileTopikContentFailure {
 type CompileTopikContentResult = CompileTopikContentSuccess | CompileTopikContentFailure;
 /** Admit source once, including compiled asset references, and produce a reader tree. */
 export declare function compileTopikContent(source: string, options?: CompileTopikContentOptions): CompileTopikContentResult;
-//#endregion
-//#region src/index.d.ts
 export type TopikComponentKind = "block" | "inline";
 export type TopikAttributeType = "string" | "number" | "boolean" | "enum";
-//#endregion
 export type { AnalyzeTopikContentOptions, AnalyzeTopikContentResult, AttributeDefinition, AuthoredAttributeValue, Branch, ChildConstraint, CodeLineSelection, CodePresentation, CodePresentationEffectiveOptions, CodePresentationOptions, CodeTemplate, CompileTopikContentFailure, CompileTopikContentOptions, CompileTopikContentResult, CompileTopikContentSuccess, CompiledTopikContent, Component, ComponentDefinition, ComponentSchema, Conditional, ContentDocument, Diagnostic, Expression, ExtractTopikAssetOccurrencesOptions, FormatTopikContentFailure, FormatTopikContentOptions, FormatTopikContentResult, FormatTopikContentSuccess, ParseResult, ParseTopikContentOptions, Registry, RenderableTreeNode, ResolvedTopikContentConfig, RewriteTopikAssetOccurrencesFailure, RewriteTopikAssetOccurrencesOptions, RewriteTopikAssetOccurrencesResult, RewriteTopikAssetOccurrencesSuccess, RewriteTopikNavigationResult, Scalar, TextTemplate, TopikAnalyzedHeading, TopikAssetOccurrence, TopikAssetOccurrenceKind, TopikAssetOccurrenceSemantics, TopikAssetReferenceDefinition, TopikAssetReferenceRole, TopikAssetReferenceSlot, TopikAssetReferenceValidation, TopikComponentAttributeDefinition, TopikComponentDefinition, TopikComponentName, TopikContentConfig, TopikContentDiagnostic, TopikContentDiagnosticLevel, TopikContentLink, TopikContentLinkKind, TopikContentNode, TopikGeneratedAssetName, TopikHeading, TopikNavigationReference, TopikResourceReference, ValidateTopikContentOptions, ValidateTopikContentResult, Variable };

package/dist/index.mjs

@@ -13,7 +13,7 @@ import { gfmTableFromMarkdown, gfmTableToMarkdown } from "mdast-util-gfm-table";
 import { gfmTaskListItemFromMarkdown, gfmTaskListItemToMarkdown } from "mdast-util-gfm-task-list-item";
 import { defaultHandlers, toMarkdown } from "mdast-util-to-markdown";
 import GithubSlugger from "github-slugger";
-//#region src/extensions/accordion.ts
+// src/extensions/accordion.ts
 const accordionDefinition = {
 	kind: "block",
 	render: "TopikAccordion",
@@ -31,8 +31,7 @@ const accordionDefinition = {
 	},
 	children: "blocks"
 };
-//#endregion
-//#region src/extensions/badge.ts
+// src/extensions/badge.ts
 const badgeDefinition = {
 	kind: "inline",
 	render: "TopikBadge",
@@ -51,8 +50,7 @@ const badgeDefinition = {
 	} },
 	children: "inline"
 };
-//#endregion
-//#region src/extensions/callout.ts
+// src/extensions/callout.ts
 const calloutDefinition = {
 	kind: "block",
 	render: "TopikCallout",
@@ -72,8 +70,7 @@ const calloutDefinition = {
 	},
 	children: "blocks"
 };
-//#endregion
-//#region src/extensions/cards.ts
+// src/extensions/cards.ts
 const cardGridDefinition = {
 	kind: "block",
 	render: "TopikCardGrid",
@@ -109,8 +106,7 @@ const cardDefinition = {
 	children: "blocks",
 	selfClosing: true
 };
-//#endregion
-//#region src/extensions/code.ts
+// src/extensions/code.ts
 const codeGroupDefinition = {
 	kind: "block",
 	render: "TopikCodeGroup",
@@ -146,8 +142,7 @@ const codeTabDefinition = {
 	},
 	allowedParents: ["codeGroup"]
 };
-//#endregion
-//#region src/extensions/figure.ts
+// src/extensions/figure.ts
 const figureDefinition = {
 	kind: "block",
 	render: "TopikFigure",
@@ -184,8 +179,7 @@ const figureDefinition = {
 	},
 	children: "none"
 };
-//#endregion
-//#region src/extensions/math.ts
+// src/extensions/math.ts
 const mathDefinition = {
 	kind: "block",
 	render: "TopikMath",
@@ -210,8 +204,7 @@ const mathInlineDefinition = {
 	} },
 	children: "none"
 };
-//#endregion
-//#region src/extensions/native.ts
+// src/extensions/native.ts
 const nativeComponents = {
 	codeBlock: {
 		name: "codeBlock",
@@ -312,8 +305,7 @@ const nativeComponents = {
 		description: "A header cell inside a Markdown table."
 	}
 };
-//#endregion
-//#region src/extensions/quiz.ts
+// src/extensions/quiz.ts
 const quizDefinition = {
 	kind: "block",
 	render: "TopikQuiz",
@@ -376,8 +368,7 @@ const explanationDefinition = {
 	children: "blocks",
 	allowedParents: ["question"]
 };
-//#endregion
-//#region src/extensions/steps.ts
+// src/extensions/steps.ts
 const stepsDefinition = {
 	kind: "block",
 	render: "TopikSteps",
@@ -399,8 +390,7 @@ const stepDefinition = {
 	children: "blocks",
 	allowedParents: ["steps"]
 };
-//#endregion
-//#region src/extensions/tabs.ts
+// src/extensions/tabs.ts
 const tabsDefinition = {
 	kind: "block",
 	render: "TopikTabs",
@@ -423,8 +413,7 @@ const tabDefinition = {
 	children: "blocks",
 	allowedParents: ["tabs"]
 };
-//#endregion
-//#region src/extensions/underline.ts
+// src/extensions/underline.ts
 const underlineDefinition = {
 	kind: "inline",
 	render: "TopikUnderline",
@@ -432,8 +421,7 @@ const underlineDefinition = {
 	attributes: {},
 	children: "inline"
 };
-//#endregion
-//#region src/registry.ts
+// src/registry.ts
 const TOPIK_CONTENT_SCHEMA_VERSION = "0.2.2";
 const CALLOUT_VARIANTS = [
 	"info",
@@ -537,8 +525,7 @@ function getEffectiveProps(component, registry = components) {
 		...component.props
 	};
 }
-//#endregion
-//#region src/limits.ts
+// src/limits.ts
 /** Fixed admission limits, measured in UTF-16 code units and tree nodes. */
 const CONTENT_LIMITS = Object.freeze({
 	sourceLength: 1e6,
@@ -671,8 +658,7 @@ function assertDataLimits(root, options = {}) {
 		}
 	}
 }
-//#endregion
-//#region src/expressions.ts
+// src/expressions.ts
 const identifier = /^[A-Za-z_][A-Za-z0-9_]*/;
 const number = /^[+-]?(?:\d+(?:\.\d*)?|\.\d+)(?:[eE][+-]?\d+)?/;
 const unsafeKeys$1 = /* @__PURE__ */ new Set([
@@ -823,8 +809,7 @@ function writeExpression(expression) {
 	if (result.length > CONTENT_LIMITS.expressionLength) throw new ContentLimitError(`Content exceeds the expression length limit of ${CONTENT_LIMITS.expressionLength}`);
 	return result;
 }
-//#endregion
-//#region src/node-grammar.ts
+// src/node-grammar.ts
 const blockTypes = /* @__PURE__ */ new Set([
 	"paragraph",
 	"heading",
@@ -887,8 +872,7 @@ function isContentKind(node, kind, registry) {
 function isInlineParent(node, registry) {
 	return inlineParentTypes.has(node.type) || node.type === "topikComponent" && isContentKind(node, "inline", registry);
 }
-//#endregion
-//#region src/node-validation.ts
+// src/node-validation.ts
 function record(value) {
 	return value !== null && typeof value === "object" && !Array.isArray(value);
 }
@@ -1053,8 +1037,7 @@ function nodeShapeProblem(value, registry) {
 		].includes(node.referenceType)) return "References require a supported reference type";
 	}
 }
-//#endregion
-//#region src/code-presentation.ts
+// src/code-presentation.ts
 /** Bounds are independent of ordinary, unpresented code admission. */
 const CODE_PRESENTATION_LIMITS = Object.freeze({
 	metadataLength: 16384,
@@ -1500,8 +1483,7 @@ function codePresentationProblem(node, seen = /* @__PURE__ */ new Set()) {
 		throw error;
 	}
 }
-//#endregion
-//#region src/presentation-output.ts
+// src/presentation-output.ts
 /**
 * Reserve a conservative serialization budget before allocating reader rows.
 * Each text unit can expand to six HTML units; each row reserves 768 units for
@@ -1533,8 +1515,7 @@ function assertCodePresentationOutputLimit(document) {
 		for (const child of node.children ?? []) stack.push(child);
 	}
 }
-//#endregion
-//#region src/document-index.ts
+// src/document-index.ts
 function referenceIdentifier(identifier) {
 	return identifier.replace(/[\t\n\r ]+/gu, " ").replace(/^ | $/gu, "").toLowerCase().toUpperCase().toLowerCase();
 }
@@ -1598,8 +1579,7 @@ function materializeReferences(document, index = indexDocument(document)) {
 		delete resource.referenceType;
 	}
 }
-//#endregion
-//#region src/validation.ts
+// src/validation.ts
 function issue(id, message) {
 	return {
 		id,
@@ -1839,8 +1819,7 @@ function validateDocumentWithIndex(document, registry) {
 		index
 	};
 }
-//#endregion
-//#region src/document-meaning.ts
+// src/document-meaning.ts
 /** Compare admitted authoring trees, retaining explicit heading IDs and every authored branch.
 * Source positions, cosmetic spelling and derived metadata do not affect equality.
 * This compares meaning; it does not validate arbitrary caller-constructed trees.
@@ -1925,8 +1904,7 @@ function equal(left, right) {
 	const keys = Object.keys(a);
 	return keys.length === Object.keys(b).length && keys.every((key) => Object.hasOwn(b, key) && equal(a[key], b[key]));
 }
-//#endregion
-//#region src/tag-options.ts
+// src/tag-options.ts
 /** Parser and writer share the exact registry attribute admission. */
 function tagOptions(registry) {
 	return {
@@ -1934,8 +1912,7 @@ function tagOptions(registry) {
 		escapedWhitespace: Object.fromEntries(Object.entries(registry).map(([name, definition]) => [name, Object.entries(definition.attributes).filter(([, attribute]) => attribute.type === "string" && attribute.escapedWhitespace).map(([key]) => key)]))
 	};
 }
-//#endregion
-//#region src/gfm.ts
+// src/gfm.ts
 function gfmSyntax() {
 	return [
 		gfmFootnote(),
@@ -1960,8 +1937,7 @@ function gfmToMarkdown() {
 		gfmTaskListItemToMarkdown()
 	] };
 }
-//#endregion
-//#region src/heading-ids.ts
+// src/heading-ids.ts
 const validId = /^[A-Za-z0-9_.:-]+$/;
 /** An independent inline construct, claimed before generic tag tokenization. */
 function headingIdSyntax() {
@@ -2075,8 +2051,7 @@ function headingIdToMarkdown() {
 		}
 	} };
 }
-//#endregion
-//#region src/reference-source.ts
+// src/reference-source.ts
 const references = /* @__PURE__ */ new WeakMap();
 function referenceSourceExtension() {
 	return { enter: {
@@ -2131,8 +2106,7 @@ function createReferenceSourceLookup(source, reparse) {
 		return match?.url === node.url ? match.reference : "";
 	};
 }
-//#endregion
-//#region src/parser-limits.ts
+// src/parser-limits.ts
 /** Refuse expensive syntax before micromark resolves containers and inline delimiters. */
 function parserLimitSyntax(source) {
 	let steps = 0;
@@ -2182,8 +2156,7 @@ function parserLimitSyntax(source) {
 		}
 	};
 }
-//#endregion
-//#region src/line-endings.ts
+// src/line-endings.ts
 /** Normalize source syntax, leaving entity-decoded characters and original locations distinct. */
 function normalizeLineEndings(source) {
 	const crlfOffsets = [];
@@ -2221,8 +2194,7 @@ function normalizeLineEndings(source) {
 		restorePositions
 	};
 }
-//#endregion
-//#region src/parser.ts
+// src/parser.ts
 function declarations(registry) {
 	return Object.fromEntries(Object.entries(registry).map(([name, definition]) => [name, { kind: definition.kind }]));
 }
@@ -2420,8 +2392,7 @@ function normalizeTables(root, remainingNodes) {
 	}
 	walk(root);
 }
-//#endregion
-//#region src/markdown-marks.ts
+// src/markdown-marks.ts
 /** Choose delimiters before writing so handlers and their lookahead agree. */
 function markWriterExtension(root) {
 	const markers = /* @__PURE__ */ new WeakMap();
@@ -2469,12 +2440,10 @@ function markWriterExtension(root) {
 		strong: handler("strong")
 	} };
 }
-//#endregion
-//#region src/reference-writer.ts
+// src/reference-writer.ts
 /** Escapes and entities are part of reference identity, not decoded Markdown text. */
-function referenceLabel(node, state) {
-	const value = referenceSourceLabel(node);
-	return state.stack.includes("tableCell") ? value.replaceAll("|", "\\|") : value;
+function referenceLabel(node) {
+	return referenceSourceLabel(node);
 }
 function referenceWriterExtension() {
 	const reference = (untyped, _parent, state, info) => {
@@ -2488,9 +2457,9 @@ function referenceWriterExtension() {
 			after: "]",
 			...tracker.current()
 		};
-		const text = node.type === "imageReference" ? state.safe(node.alt ?? "", context) : state.containerPhrasing(node, context);
+		const text = node.type === "imageReference" ? state.safe(node.alt ?? "", context).replaceAll("\n", "
") : state.containerPhrasing(node, context);
 		labelExit();
-		const label = referenceLabel(node, state);
+		const label = referenceLabel(node);
 		exit();
 		return `${prefix}${text}]${node.referenceType === "full" || !text || text !== label ? `[${label}]` : node.referenceType === "collapsed" ? "[]" : ""}`;
 	};
@@ -2499,8 +2468,7 @@ function referenceWriterExtension() {
 		imageReference: Object.assign(reference.bind(null), { peek: () => "!" })
 	} };
 }
-//#endregion
-//#region src/resource-writer.ts
+// src/resource-writer.ts
 const entity = /&(?:#(?:\d{1,7}|x[\da-f]{1,6})|[\da-z]{1,31});/giu;
 /** Escape Markdown syntax, without changing the spelling of ordinary URL bytes. */
 function destination(url, state) {
@@ -2556,7 +2524,7 @@ function resourceWriterExtension() {
 			...info,
 			before: "![",
 			after: "]"
-		});
+		}).replaceAll("\n", "
");
 		labelExit();
 		const result = `![${alt}](${destination(node.url, state)}${title(node.title, state)})`;
 		exit();
@@ -2565,7 +2533,7 @@ function resourceWriterExtension() {
 	const definition = (untyped, _parent, state) => {
 		const node = untyped;
 		const exit = state.enter("definition");
-		const result = `[${referenceLabel(node, state)}]: ${destination(node.url, state)}${title(node.title, state)}`;
+		const result = `[${referenceLabel(node)}]: ${destination(node.url, state)}${title(node.title, state)}`;
 		exit();
 		return result;
 	};
@@ -2577,8 +2545,7 @@ function resourceWriterExtension() {
 		definition
 	} };
 }
-//#endregion
-//#region src/whitespace-writer.ts
+// src/whitespace-writer.ts
 function boundaryWhitespaceWriterExtension() {
 	return { handlers: { text(node, parent, state, info) {
 		if (parent?.type !== "delete" && parent?.type !== "tableCell" && !node.value.includes("\n")) return defaultHandlers.text(node, parent, state, info);
@@ -2606,8 +2573,7 @@ function boundaryWhitespaceWriterExtension() {
 		})).join("
") + after;
 	} } };
 }
-//#endregion
-//#region src/code-writer.ts
+// src/code-writer.ts
 /*!
 * @license MIT
 * Header escaping follows mdast-util-to-markdown's safe utility, with linear
@@ -2737,8 +2703,7 @@ function codeWriterExtension() {
 		}
 	} } };
 }
-//#endregion
-//#region src/code-presentation-writer.ts
+// src/code-presentation-writer.ts
 /** Header source has already been encoded for exactly one CommonMark decoding pass. */
 function codePresentationWriterExtension() {
 	return { handlers: { topikCodePresentation(node) {
@@ -2759,8 +2724,7 @@ function codePresentationWriterExtension() {
 		return scope;
 	} } };
 }
-//#endregion
-//#region src/writer.ts
+// src/writer.ts
 /**
 * Count payload deltas from an empty-template/code skeleton. A cheap source
 * floor refuses obvious overflows before cloning or baseline serialization;
@@ -2999,8 +2963,7 @@ function writeMarkdown(tree, registry) {
 		fences: true
 	});
 }
-//#endregion
-//#region src/markdown.ts
+// src/markdown.ts
 function parseDocument(source, registry = components, formatVersion = 1) {
 	const result = parseDocumentTree(source, registry, formatVersion);
 	return result.document && result.diagnostics.length === 0 ? {
@@ -3032,8 +2995,7 @@ function formatDocument(source, registry = components) {
 		};
 	}
 }
-//#endregion
-//#region src/assets.ts
+// src/assets.ts
 /** Rewrite asset definitions once, preserving reference identity and unrelated navigation. */
 function rewriteAssets(document, replace, registry = components) {
 	const inputErrors = validateDocument(document, registry);
@@ -3066,8 +3028,7 @@ function rewriteAssets(document, replace, registry = components) {
 	if (errors.length) throw new Error(errors.map((error) => error.message).join("; "));
 	return cloned;
 }
-//#endregion
-//#region src/traversal.ts
+// src/traversal.ts
 function walkContent(node, visit, path = []) {
 	assertDataLimits(node, { plain: true });
 	assertTreeLimits(node);
@@ -3083,8 +3044,7 @@ function plainText(node) {
 	if (node.type === "break") return "\n";
 	return (node.children ?? []).map(plainText).join("");
 }
-//#endregion
-//#region src/headings.ts
+// src/headings.ts
 function assignTopikHeadingIds(document) {
 	const headings = [];
 	walkContent(document, (node) => {
@@ -3114,8 +3074,7 @@ function assignHeadingIds(headings) {
 		};
 	});
 }
-//#endregion
-//#region src/evaluate.ts
+// src/evaluate.ts
 var ContentEvaluationError = class extends Error {
 	constructor(message) {
 		super(message);
@@ -3341,8 +3300,7 @@ function resolveDocument(document, context, registry, includeHeadingIds) {
 	}
 	return resolved;
 }
-//#endregion
-//#region src/config.ts
+// src/config.ts
 function plainObject(value) {
 	return value !== null && typeof value === "object" && (Object.getPrototypeOf(value) === Object.prototype || Object.getPrototypeOf(value) === null);
 }
@@ -3463,16 +3421,14 @@ function mergeTopikContentConfig(extension = {}) {
 		variables: cloneSchema(variables)
 	};
 }
-//#endregion
-//#region src/content.ts
+// src/content.ts
 /** Parse the authoring tree. Use validateTopikContent at publication boundaries. */
 function parseTopikContent(source, options = {}) {
 	const result = parseDocumentTree(source, mergeTopikContentConfig(options.config).components);
 	if (!result.document) throw new Error("Content could not be parsed");
 	return result.document;
 }
-//#endregion
-//#region src/asset-reference-policy.ts
+// src/asset-reference-policy.ts
 const TOPIK_ASSET_REFERENCE_VERSION = "topik-asset-reference-v1";
 const TOPIK_GENERATED_ASSET_NAME_VALIDATOR = /^auto-v1-[a-z2-7]{51}[aq]$/u;
 /** Public grammar descriptor. Runtime admission uses an isolated boundary. */
@@ -3603,8 +3559,7 @@ function containsNonAscii(value) {
 	for (const character of value) if ((character.codePointAt(0) ?? 0) > 127) return true;
 	return false;
 }
-//#endregion
-//#region src/resource-references.ts
+// src/resource-references.ts
 /** Version of the portable compiled-content resource reference contract. */
 const TOPIK_RESOURCE_REFERENCE_VERSION = 1;
 const RESOURCE_NAME = /^[a-z0-9]+(?:-[a-z0-9]+)*$/u;
@@ -3637,8 +3592,7 @@ function serializeTopikResourceReference(reference) {
 	if (!parsed) throw new TypeError("Resource reference is not valid");
 	return `ref://${kind}/${parsed.name}${parsed.search}${parsed.hash ? `#${parsed.hash}` : ""}`;
 }
-//#endregion
-//#region src/diagnostics.ts
+// src/diagnostics.ts
 const TOPIK_LINK_DIAGNOSTIC_MESSAGES = {
 	"link-asset-invalid": "Asset link target is not a canonical generated name.",
 	"link-asset-navigation-unsupported": "Navigation targets cannot use generated Asset names.",
@@ -3831,8 +3785,7 @@ function safeDiagnosticBasename(file) {
 function isSafeRelativeDiagnosticLabel(value) {
 	return /^(?!\.\.?$)[a-z0-9._-]+(?:[\\/][a-z0-9._-]+)*$/iu.test(value);
 }
-//#endregion
-//#region src/links.ts
+// src/links.ts
 const ALLOWED_SCHEMES = /* @__PURE__ */ new Set([
 	"asset",
 	"http",
@@ -3964,8 +3917,7 @@ function isNetworkPathReference(value) {
 	const isPathSeparator = (character) => character === "/" || character === "\\";
 	return isPathSeparator(value[0]) && isPathSeparator(value[1]);
 }
-//#endregion
-//#region src/asset-references.ts
+// src/asset-references.ts
 /**
 * Closed registry for topik-asset-reference-v1. Extractors never infer a slot from an
 * attribute name and never recursively inspect arbitrary strings.
@@ -4145,8 +4097,7 @@ function removeInvalidTopikAssetReferences(document, source, options = {}) {
 	}
 	sanitize(document);
 }
-//#endregion
-//#region src/custom-assets.ts
+// src/custom-assets.ts
 /** Custom assets share URL admission, but do not extend the compiler's closed slot protocol. */
 function validateCustomAssetReferences(document, registry, allowCompiled, index = indexDocument(document)) {
 	const issues = [];
@@ -4173,8 +4124,7 @@ function validateCustomAssetReferences(document, registry, allowCompiled, index
 	}
 	return issues;
 }
-//#endregion
-//#region src/source.ts
+// src/source.ts
 function writeFailure(source, file) {
 	return {
 		ok: false,
@@ -4256,8 +4206,7 @@ function prepareSource(source, options = {}) {
 	}
 	return failure();
 }
-//#endregion
-//#region src/validate.ts
+// src/validate.ts
 /** Source admission is the same boundary used by formatting and asset rewriting. */
 function validateTopikContent(source, options = {}) {
 	const result = prepareSource(source, options);
@@ -4267,8 +4216,7 @@ function validateTopikContent(source, options = {}) {
 		errors: result.diagnostics
 	};
 }
-//#endregion
-//#region src/format.ts
+// src/format.ts
 /** Validate source before formatting so unsupported input remains an exact opaque handoff. */
 function formatTopikContent(source, options = {}) {
 	const prepared = prepareSource(source, options);
@@ -4296,8 +4244,7 @@ function formatTopikContent(source, options = {}) {
 		formatted
 	};
 }
-//#endregion
-//#region src/rewrite.ts
+// src/rewrite.ts
 function rewriteTopikAssetOccurrences(source, replace, options = {}) {
 	const prepared = prepareSource(source, options);
 	if (!prepared.ok) return prepared;
@@ -4326,8 +4273,7 @@ function rewriteTopikAssetOccurrences(source, replace, options = {}) {
 		content
 	};
 }
-//#endregion
-//#region src/navigation-rewrite.ts
+// src/navigation-rewrite.ts
 /** Rewrite actual navigation references, retaining definitions/scopes and every authored branch. */
 function rewriteTopikNavigationReferences(source, replace, options = {}) {
 	const prepared = prepareSource(source, options);
@@ -4372,7 +4318,7 @@ function rewriteTopikNavigationReferences(source, replace, options = {}) {
 	else node.url = replacement;
 	let content;
 	try {
-		content = writeDocument(prepared.document, prepared.config.components);
+		content = serializeDocument(prepared.document, prepared.config.components);
 	} catch {
 		return writeFailure(source, options.file);
 	}
@@ -4388,8 +4334,7 @@ function rewriteTopikNavigationReferences(source, replace, options = {}) {
 		diagnostics: []
 	};
 }
-//#endregion
-//#region src/render.ts
+// src/render.ts
 var ContentTag = class {
 	name;
 	attributes;
@@ -4486,8 +4431,7 @@ function transformDocument(document, config) {
 	}
 	return render(resolved);
 }
-//#endregion
-//#region src/compile.ts
+// src/compile.ts
 /** Admit source once, including compiled asset references, and produce a reader tree. */
 function compileTopikContent(source, options = {}) {
 	const prepared = prepareSource(source, {
@@ -4525,5 +4469,4 @@ function compileTopikContent(source, options = {}) {
 		};
 	}
 }
-//#endregion
 export { BADGE_VARIANTS, CALLOUT_VARIANTS, CODE_PRESENTATION_LIMITS, CONTENT_LIMITS, ContentEvaluationError, ContentLimitError, ContentTag, FORMAT_VERSION, QUIZ_QUESTION_TYPES, TOPIK_ASSET_REFERENCE_VERSION, TOPIK_CONTENT_SCHEMA_VERSION, TOPIK_GENERATED_ASSET_NAME_PATTERN, TOPIK_RESOURCE_REFERENCE_VERSION, analyzeTopikContent, assignTopikHeadingIds, compileTopikContent, components, effectiveCodePresentationOptions, evaluateDocument, extractTopikAssetOccurrences, formatDocument, formatTopikContent, getEffectiveProps, isContentTag, isTopikGeneratedAssetName, mergeTopikContentConfig, parseDocument, parseTopikContent, parseTopikGeneratedAssetName, parseTopikResourceReference, removeInvalidTopikAssetReferences, removeInvalidTopikNavigationReferences, rewriteAssets, rewriteTopikAssetOccurrences, rewriteTopikNavigationReferences, sameDocumentMeaning, sanitizeTopikContentDiagnostic, sanitizeTopikDiagnosticFile, serializeTopikResourceReference, toTopikContentDiagnostic, topikAssetReferenceSlots, topikComponents, topikLinkDiagnosticMessage, transformTopikContent, validateDocument, validateTopikAssetReference, validateTopikBrowserHref, validateTopikContent, validateTopikHref, validateTopikNavigationHref, writeDocument };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@topik/content",
-  "version": "0.1.0-alpha.6",
+  "version": "0.1.0-alpha.7",
   "description": "Declarative Topik content model, Markdown format, validation and rendering",
   "license": "MIT",
   "repository": {
@@ -20,37 +20,37 @@
     "access": "public"
   },
   "dependencies": {
+    "@topik/remark-tags": "0.1.0-alpha.7",
     "@types/mdast": "^4.0.4",
     "@types/unist": "^3.0.3",
     "github-slugger": "^2.0.0",
     "mdast-util-from-markdown": "^2.1.0",
     "mdast-util-frontmatter": "^2.0.1",
     "mdast-util-gfm-footnote": "^2.1.0",
-    "mdast-util-gfm-strikethrough": "^2.0.0",
+    "mdast-util-gfm-strikethrough": "^2.0.1",
     "mdast-util-gfm-table": "^2.0.0",
     "mdast-util-gfm-task-list-item": "^2.0.0",
-    "mdast-util-to-markdown": "^2.1.2",
+    "mdast-util-to-markdown": "^2.2.1",
     "micromark-extension-frontmatter": "^2.0.0",
     "micromark-extension-gfm-footnote": "^2.1.0",
     "micromark-extension-gfm-strikethrough": "^2.1.0",
     "micromark-extension-gfm-table": "^2.1.2",
     "micromark-extension-gfm-task-list-item": "^2.1.0",
-    "micromark-util-decode-string": "^2.0.1",
-    "@topik/remark-tags": "0.1.0-alpha.6"
+    "micromark-util-decode-string": "^2.0.1"
   },
   "devDependencies": {
-    "@types/node": "22.20.4",
-    "@vitest/coverage-v8": "5.0.4",
-    "micromark-util-types": "^2.0.2",
+    "@types/node": "22.20.5",
+    "@vitest/coverage-v8": "5.0.5",
+    "micromark-util-types": "^2.0.3",
     "typescript": "^7.0.2",
-    "vite": "npm:@voidzero-dev/vite-plus-core@1.2.0",
-    "vite-plus": "1.2.0",
-    "vitest": "5.0.4"
+    "vite": "npm:@voidzero-dev/vite-plus-core@1.4.0",
+    "vite-plus": "1.4.0",
+    "vitest": "5.0.5"
   },
   "devEngines": {
     "runtime": {
       "name": "node",
-      "version": "^22.18.0 || ^24.11.0 || >=26.0.0"
+      "version": "^22.23.4 || ^24.11.0 || >=26.0.0"
     }
   },
   "engines": {