@effected/markdown 0.19.0 → 0.21.0

package/index.d.ts

@@ -1,5 +1,4 @@
-import { Data, Effect, Result, Schema, Stream } from "effect";
-//#region src/MarkdownNode.d.ts
+import { Data, Effect, Option, Result, Schema, Stream } from "effect";
 declare const Point_base: Schema.Class<Point, Schema.Struct<{
   readonly line: Schema.Number;
   readonly column: Schema.Number;
@@ -941,8 +940,6 @@ type MarkdownNodeType = MarkdownNode["type"];
 type MarkdownNodeOfType<T extends MarkdownNodeType> = Extract<MarkdownNode, {
   readonly type: T;
 }>;
-//#endregion
-//#region src/MarkdownDiagnostic.d.ts
 /**
  * Error codes `Markdown.parse`/`MarkdownDocument.parse` can fail with.
  * Currently exactly one, `"NestingDepthExceeded"`, the hardening-guard trip;
@@ -999,8 +996,6 @@ export declare class MarkdownDiagnostic extends MarkdownDiagnostic_base {
     readonly length: number;
   }): MarkdownDiagnostic;
 }
-//#endregion
-//#region src/Markdown.d.ts
 /**
  * The markdown dialects the parser can be pointed at. `"gfm"` — CommonMark
  * 0.31.2 plus the GitHub extensions (tables, strikethrough, autolink
@@ -1354,8 +1349,6 @@ export declare class Markdown {
    */
   static readonly MarkdownFromString: Schema.Codec<Root, string>;
 }
-//#endregion
-//#region src/MarkdownEdit.d.ts
 /**
  * A single path segment: a `number` for child indices in the node tree, or a
  * `string` for named addressing (reserved, e.g. for definition identifiers).
@@ -1412,8 +1405,6 @@ export declare class MarkdownEdit extends MarkdownEdit_base {
    */
   static applyAll(text: string, edits: ReadonlyArray<MarkdownEdit>): string;
 }
-//#endregion
-//#region src/MarkdownDocument.d.ts
 /**
  * A heading entry from {@link MarkdownDocument.headings}: the {@link Heading}
  * node plus the derivations navigation wants — its `depth` and its plain-text
@@ -1598,27 +1589,34 @@ declare const MarkdownDocument_base: Schema.Class<MarkdownDocument, Schema.Struc
  */
 export declare class MarkdownDocument extends MarkdownDocument_base {
   /**
-   * The document's frontmatter capture, or `undefined` when there is none.
+   * The document's frontmatter capture, or `Option.none()` when there is
+   * none.
    *
    * @remarks
    * Derived from the tree rather than stored: a {@link Frontmatter} node can
    * only ever sit at the head of `root.children` (the capture fires at most
    * once, at offset 0), so the tree is the single source of truth and the
-   * accessor can never disagree with it. `undefined` covers both a document
-   * with no frontmatter block and one parsed with the capture toggle off —
-   * {@link MarkdownDocument.hasFrontmatterBlock} tells the two apart.
+   * accessor can never disagree with it. `Option.none()` covers both a
+   * document with no frontmatter block and one parsed with the capture toggle
+   * off — {@link MarkdownDocument.hasFrontmatterBlock} tells the two apart.
+   *
+   * An `Option` rather than `Frontmatter | undefined` because this is a
+   * lookup that can miss, and the kit's lookups return `Option` — the same
+   * shape as the sibling format packages' tree lookups (`JsoncNode.find`,
+   * `YamlNode.find`). A derived getter is a lookup, not a data field: it
+   * recomputes from the tree on every access.
    */
-  get frontmatter(): Frontmatter | undefined;
+  get frontmatter(): Option.Option<Frontmatter>;
   /**
    * Whether the source opens with a well-formed frontmatter block —
    * regardless of how the document was parsed.
    *
    * @remarks
    * The structural signal that disambiguates the `frontmatter` accessor's
-   * `undefined`: capture is opt-in (`MarkdownParseOptions.frontmatter`
+   * `Option.none()`: capture is opt-in (`MarkdownParseOptions.frontmatter`
    * defaults off), so a document whose source visibly starts with `---` can
    * still carry no capture node — spec-correct CommonMark reads the fences as
-   * a thematic break plus content. `frontmatter === undefined` with
+   * a thematic break plus content. An empty `frontmatter` with
    * `hasFrontmatterBlock === true` means exactly "parsed with capture off";
    * with `false` it means the source genuinely has no block.
    *
@@ -1665,9 +1663,10 @@ export declare class MarkdownDocument extends MarkdownDocument_base {
    * document repeatedly should bind `document.sections` once instead.
    *
    * @param options - Depth restriction.
-   * @returns The first matching section, or `undefined`.
+   * @returns The first matching section, or `Option.none()` when no section
+   *   matches.
    */
-  firstSection(options?: SectionQueryOptions): DocumentSection | undefined;
+  firstSection(options?: SectionQueryOptions): Option.Option<DocumentSection>;
   /**
    * The first section whose heading matches, in document order.
    *
@@ -1683,9 +1682,10 @@ export declare class MarkdownDocument extends MarkdownDocument_base {
    *
    * @param match - A string, a RegExp, or a predicate.
    * @param options - Depth restriction, applied before matching.
-   * @returns The first matching section, or `undefined`.
+   * @returns The first matching section, or `Option.none()` when no section
+   *   matches.
    */
-  sectionByHeading(match: SectionHeadingMatch, options?: SectionQueryOptions): DocumentSection | undefined;
+  sectionByHeading(match: SectionHeadingMatch, options?: SectionQueryOptions): Option.Option<DocumentSection>;
   /**
    * Every link-bearing node in the document, in document order: links,
    * images, definitions, and the reference forms resolved through the
@@ -1706,7 +1706,7 @@ export declare class MarkdownDocument extends MarkdownDocument_base {
    *
    * @remarks
    * A string selector matches on the node's `type` tag and narrows the
-   * result (`find("heading")` is `Heading | undefined`); a type-guard
+   * result (`find("heading")` is `Option<Heading>`); a type-guard
    * predicate narrows the same way, and a plain predicate returns the wide
    * `MarkdownNode` union. The returned node is the document's own — matched
    * and returnable by identity, so it feeds `MarkdownFormat.modify`
@@ -1715,11 +1715,12 @@ export declare class MarkdownDocument extends MarkdownDocument_base {
    * hand-built or foreign decoded tree) is a thrown defect.
    *
    * @param selector - A node `type` tag or a predicate over nodes.
-   * @returns The first matching node in document order, or `undefined`.
+   * @returns The first matching node in document order, or `Option.none()`
+   *   when none matches.
    */
-  find<T extends MarkdownNodeType>(selector: T): MarkdownNodeOfType<T> | undefined;
-  find<T extends MarkdownNode>(selector: (node: MarkdownNode) => node is T): T | undefined;
-  find(selector: (node: MarkdownNode) => boolean): MarkdownNode | undefined;
+  find<T extends MarkdownNodeType>(selector: T): Option.Option<MarkdownNodeOfType<T>>;
+  find<T extends MarkdownNode>(selector: (node: MarkdownNode) => node is T): Option.Option<T>;
+  find(selector: (node: MarkdownNode) => boolean): Option.Option<MarkdownNode>;
   /**
    * Find every node matching a selector, in document pre-order — the same
    * order {@link MarkdownVisitor} enters nodes, starting at the root itself.
@@ -1767,8 +1768,6 @@ export declare class MarkdownDocument extends MarkdownDocument_base {
    */
   static readonly parse: (text: string, options?: MarkdownParseOptions | undefined) => Effect.Effect<MarkdownDocument, MarkdownParseError, never>;
 }
-//#endregion
-//#region src/Frontmatter.d.ts
 declare const FrontmatterFormatMismatchError_base: Schema.Class<FrontmatterFormatMismatchError, Schema.TaggedStruct<"FrontmatterFormatMismatchError", {
   /** The format the codec decodes. */
   readonly expected: Schema.Literals<readonly ["yaml", "toml", "json"]>;
@@ -2061,8 +2060,6 @@ export declare class MarkdownFrontmatter {
    */
   static setToString<T, E, RD = never, RE = never>(schema: Schema.Codec<T, E, RD, RE>, codec: FrontmatterCodec): (document: MarkdownDocument, data: T) => Effect.Effect<string, FrontmatterWriteError, RE>;
 }
-//#endregion
-//#region src/FrontmatterResolver.d.ts
 declare const SchemaDeclarationByUrl_base: Schema.Class<SchemaDeclarationByUrl, Schema.TaggedStruct<"ByUrl", {
   /** The URL as written in the declaration. */
   readonly url: Schema.String;
@@ -2292,8 +2289,6 @@ export declare class SchemaResolver {
    */
   static fromRegistry(registrations: Readonly<Record<string, Schema.Top>>): FrontmatterSchemaResolver;
 }
-//#endregion
-//#region src/FrontmatterSource.d.ts
 /**
  * The three line-terminator spellings a fence line may end with. Recorded by
  * {@link FrontmatterSource.split} as fidelity — what the source's fence
@@ -2430,8 +2425,6 @@ export declare class FrontmatterSource {
    */
   static join(split: FrontmatterSourceSplit): string;
 }
-//#endregion
-//#region src/JsonFrontmatter.d.ts
 /**
  * The json frontmatter codec, over `@effected/jsonc`.
  *
@@ -2457,8 +2450,6 @@ export declare class FrontmatterSource {
  * @public
  */
 export declare const JsonFrontmatter: FrontmatterCodec;
-//#endregion
-//#region src/MarkdownFormat.d.ts
 /**
  * A range accepted at the `format`/`formatToString` call sites: either a
  * {@link MarkdownRange} instance or a plain `{ offset, length }` literal (the
@@ -2672,8 +2663,6 @@ export declare class MarkdownFormat {
    */
   static readonly modifyToString: (document: MarkdownDocument, target: MarkdownNode, replacement: string | MarkdownNode) => Effect.Effect<string, MarkdownModificationError, never>;
 }
-//#endregion
-//#region src/MarkdownTransform.d.ts
 /**
  * The node `type` tags whose handler may change the node's type — the
  * phrasing-only types, i.e. every member of `PhrasingContent` that is
@@ -2917,15 +2906,13 @@ export declare class MarkdownTransform {
    */
   static sections(root: Root, options: SectionSpanOptions): ReadonlyArray<SectionSpan>;
 }
-//#endregion
-//#region src/MarkdownVisitor.d.ts
 /**
  * The discriminated union of markdown visitor events, in document pre-order.
  * `Enter` fires when the walk reaches a node, `Exit` when it leaves — for a
  * leaf the two fire back to back. Every variant carries `path` (child
  * indexes from the root; the root's own path is empty) and `depth`
  * (zero-based; the root is 0). `Error` is terminal: it carries the
- * depth-guard diagnostic for a decoded foreign tree nested past
+ * depth-guard diagnostic for a hand-constructed tree nested past
  * `MAX_NESTING_DEPTH` and nothing follows it.
  *
  * @public
@@ -3069,8 +3056,9 @@ export declare const MarkdownVisitorEvent: {
   }, "_tag">;
 };
 /**
- * Walks a parsed markdown tree as a lazy `Stream` of `Enter`/`Exit` events in
- * document pre-order. Not instantiable.
+ * Walks a parsed markdown tree as a lazy sequence of `Enter`/`Exit` events in
+ * document pre-order — synchronously with {@link MarkdownVisitor.walk}, or as
+ * a `Stream` with {@link MarkdownVisitor.visit}. Not instantiable.
  *
  * @example
  * ```ts
@@ -3092,6 +3080,45 @@ export declare const MarkdownVisitorEvent: {
  */
 export declare class MarkdownVisitor {
   private constructor();
+  /**
+   * Walk `root` synchronously, as a lazy `Iterable` of `MarkdownVisitorEvent`
+   * in document pre-order: `Enter` and `Exit` for every node including the
+   * root and every leaf. The primitive {@link MarkdownVisitor.visit} is
+   * defined in terms of, so the two yield the same events in the same order.
+   *
+   * @remarks
+   * For callers that cannot suspend — a lint rule whose host calls it
+   * synchronously, a getter, a non-Effect adapter. Events are produced on
+   * demand: a `for…of` that `break`s stops the walk without visiting the
+   * rest of the tree. The iterable is re-iterable — every `[Symbol.iterator]()`
+   * call starts a fresh walk from the root, so binding the result once and
+   * iterating it twice walks the tree twice, independently.
+   *
+   * Not named `walkResult`: it returns no `Result`, and the walk has no
+   * failure channel to put in one. A hand-constructed tree nested past the
+   * depth cap surfaces as a terminal `MarkdownVisitorEvent` `Error` event
+   * carrying a `NestingDepthExceeded` {@link MarkdownDiagnostic}, after which
+   * nothing is yielded — the same posture as `visit`. A tree produced by
+   * `Markdown.parse` or decoded by `Mdast.fromMdast` can never trip it.
+   *
+   * @example
+   * ```ts
+   * import { Markdown, MarkdownVisitor } from "@effected/markdown";
+   * import { Result } from "effect";
+   *
+   * const root = Result.getOrThrow(Markdown.parseResult("# Hi\n\ntext\n"));
+   * const entered: Array<string> = [];
+   * for (const event of MarkdownVisitor.walk(root)) {
+   *   if (event._tag === "Enter") entered.push(event.node.type);
+   * }
+   * console.log(entered);
+   * // => ["root", "heading", "text", "paragraph", "text"]
+   * ```
+   *
+   * @param root - The tree to walk.
+   * @returns A lazy, re-iterable `Iterable` of `MarkdownVisitorEvent`.
+   */
+  static walk(root: Root): Iterable<MarkdownVisitorEvent>;
   /**
    * Create a lazy `Stream` of `MarkdownVisitorEvent` walking `root` in
    * document pre-order: `Enter` and `Exit` for every node including the
@@ -3102,10 +3129,15 @@ export declare class MarkdownVisitor {
    * @remarks
    * Infallible at the type level. A tree produced by `Markdown.parse` can
    * never trip the walk's depth guard — the parser refuses deeper input —
-   * but a decoded foreign tree (`Mdast.fromMdast`) can; the trip surfaces
-   * as a terminal `MarkdownVisitorEvent` `Error` event carrying a
-   * `NestingDepthExceeded` {@link MarkdownDiagnostic}, mirroring the typed
-   * failure `Markdown.stringify` produces for the same tree.
+   * and neither can a decoded foreign tree (`Mdast.fromMdast`), because the
+   * decode boundary refuses it first; only a hand-constructed tree can trip
+   * the guard. The trip surfaces as a terminal `MarkdownVisitorEvent`
+   * `Error` event carrying a `NestingDepthExceeded` {@link MarkdownDiagnostic},
+   * mirroring the typed failure `Markdown.stringify` produces for the same
+   * tree.
+   *
+   * Defined as `Stream.fromIterable(MarkdownVisitor.walk(root))`: every run
+   * of the stream walks afresh, and the two forms never diverge.
    *
    * @param root - The tree to walk.
    * @returns A lazy `Stream` of `MarkdownVisitorEvent`, infallible at the type
@@ -3113,8 +3145,6 @@ export declare class MarkdownVisitor {
    */
   static visit(root: Root): Stream.Stream<MarkdownVisitorEvent>;
 }
-//#endregion
-//#region src/Mdast.d.ts
 /**
  * A plain mdast node: a `type` tag plus whatever fields that type carries.
  *
@@ -3246,6 +3276,14 @@ export declare class Mdast {
    * plain tree built for `Markdown.stringify` can carry it straight in. A
    * value outside `"canonical" | "literal"` fails the decode typed.
    *
+   * **Nesting is capped at 256 levels below the root**, the same cap the
+   * parser and `Markdown.stringify` enforce. A tree with any node deeper
+   * than that, leaves included, fails typed with a `SchemaIssue.InvalidValue`
+   * issue before the schema decode runs, so hostile depth is never a defect.
+   * Because leaves count, a document the parser accepts can still be
+   * refused here: `"> ".repeat(255) + "x"` parses, but its `text` leaf sits
+   * at depth 257, and `Markdown.stringify` refuses that tree too.
+   *
    * @param input - A plain mdast tree, typically a `root`.
    * @returns A `Result` succeeding with the decoded {@link Root}, or
    *   failing with {@link MdastDecodeError} carrying the structured issue.
@@ -3295,8 +3333,6 @@ export declare class Mdast {
    */
   static toText(node: MarkdownNode, options?: MdastToTextOptions): string;
 }
-//#endregion
-//#region src/TomlFrontmatter.d.ts
 /**
  * The toml frontmatter codec, over `@effected/toml`.
  *
@@ -3320,8 +3356,6 @@ export declare class Mdast {
  * @public
  */
 export declare const TomlFrontmatter: FrontmatterCodec;
-//#endregion
-//#region src/YamlFrontmatter.d.ts
 /**
  * The yaml frontmatter codec, over `@effected/yaml`.
  *
@@ -3346,6 +3380,5 @@ export declare const TomlFrontmatter: FrontmatterCodec;
  * @public
  */
 export declare const YamlFrontmatter: FrontmatterCodec;
-//#endregion
 export type { DocumentHeading, DocumentLink, FrontmatterCodec, FrontmatterResolveError, FrontmatterSchemaError, FrontmatterSchemaResolver, FrontmatterWriteError, LinkBearingNode, MarkdownNodeOfType, MarkdownNodeType, MarkdownPath, MarkdownPhrasingOnlyType, MarkdownRangeLike, MarkdownSegment, MarkdownTransformHandlers, MarkdownTransformResult, MdastNode, MdastToTextOptions, SectionHeadingMatch, SectionQueryOptions, SectionSpan, SectionSpanOptions, ShiftHeadingsOptions };
 //# sourceMappingURL=index.d.ts.map

package/internal/blockParser.js

@@ -8,7 +8,7 @@ import { GuardExceeded } from "./carriers.js";
 import { LineIndex } from "./lineIndex.js";
 import { prepareInline } from "./rawInline.js";
 
-//#region src/internal/blockParser.ts
+// src/internal/blockParser.ts
 /** Upstream's cheap pre-filter: a line that cannot start any block. */
 const reMaybeSpecial = /^[#`~*+_=<>0-9-]/;
 var BlockParser = class {
@@ -415,5 +415,4 @@ var BlockParser = class {
 */
 const parseBlocks = (text, dialect = "commonmark", frontmatter = false) => new BlockParser(text, blockDialect(dialect), dialect, frontmatter).parse();
 
-//#endregion
 export { parseBlocks };

package/internal/blockRegistry.js

@@ -14,7 +14,7 @@ import { tableCellConstruct, tableConstruct, tableHeaderStart, tableRowConstruct
 import { taskListItemStart } from "./blocks/taskListItem.js";
 import { thematicBreakConstruct, thematicBreakStart } from "./blocks/thematicBreak.js";
 
-//#region src/internal/blockRegistry.ts
+// src/internal/blockRegistry.ts
 const constructTable = (constructs) => new Map(constructs.map((construct) => [construct.type, construct]));
 const commonmarkDialect = {
 	constructs: constructTable([
@@ -86,5 +86,4 @@ const blockDialect = (dialect) => {
 	return found;
 };
 
-//#endregion
 export { blockDialect };

package/internal/blockTypes.js

@@ -1,4 +1,4 @@
-//#region src/internal/blockTypes.ts
+// src/internal/blockTypes.ts
 /** Narrow materialized children to the flow content most constructs contain. */
 const flowChildren = (children) => children.filter((child) => child.type !== "root" && child.type !== "listItem" && child.type !== "tableRow" && child.type !== "tableCell");
 /** Narrow materialized children to the list items a list contains. */
@@ -23,5 +23,4 @@ const makeBlockNode = (type, startOffset, startLine, depth = 0) => ({
 	data: {}
 });
 
-//#endregion
 export { flowChildren, listItemChildren, makeBlockNode, tableCellChildren, tableRowChildren };

package/internal/blocks/atxHeading.js

@@ -1,6 +1,6 @@
 import { Heading } from "../../MarkdownNode.js";
 
-//#region src/internal/blocks/atxHeading.ts
+// src/internal/blocks/atxHeading.ts
 const reATXHeadingMarker = /^#{1,6}(?:[ \t]+|$)/;
 const reOnlyTrailingHashes = /^[ \t]*#+[ \t]*$/;
 const reClosingHashes = /[ \t]+#+[ \t]*$/;
@@ -50,5 +50,4 @@ const atxHeadingStart = {
 	}
 };
 
-//#endregion
 export { atxHeadingStart, headingConstruct };

package/internal/blocks/blockquote.js

@@ -2,7 +2,7 @@ import { Blockquote } from "../../MarkdownNode.js";
 import { flowChildren } from "../blockTypes.js";
 import { isSpaceOrTab, peekCode } from "../preprocess.js";
 
-//#region src/internal/blocks/blockquote.ts
+// src/internal/blocks/blockquote.ts
 const C_GREATERTHAN = 62;
 /** Blockquote: continues while each line carries its `>` marker. */
 const blockquoteConstruct = {
@@ -36,5 +36,4 @@ const blockquoteStart = {
 	}
 };
 
-//#endregion
 export { blockquoteConstruct, blockquoteStart };

package/internal/blocks/code.js

@@ -2,7 +2,7 @@ import { Code } from "../../MarkdownNode.js";
 import { isSpaceOrTab, peekCode } from "../preprocess.js";
 import { unescapeString } from "../unescape.js";
 
-//#region src/internal/blocks/code.ts
+// src/internal/blocks/code.ts
 const reBlankLine = /^[ \t]*$/;
 const reClosingCodeFence = /^(?:`{3,}|~{3,})(?=[ \t]*$)/;
 /**
@@ -86,5 +86,4 @@ const codeConstruct = {
 	}
 };
 
-//#endregion
 export { codeConstruct };

package/internal/blocks/document.js

@@ -1,6 +1,6 @@
 import { Root } from "../../MarkdownNode.js";
 
-//#region src/internal/blocks/document.ts
+// src/internal/blocks/document.ts
 /** The document root: contains everything except a bare list item. */
 const documentConstruct = {
 	type: "document",
@@ -13,5 +13,4 @@ const documentConstruct = {
 	})
 };
 
-//#endregion
 export { documentConstruct };

package/internal/blocks/fencedCode.js

@@ -1,4 +1,4 @@
-//#region src/internal/blocks/fencedCode.ts
+// src/internal/blocks/fencedCode.ts
 const reCodeFence = /^`{3,}(?!.*`)|^~{3,}/;
 const fenceCharOf = (char) => char === "`" || char === "~" ? char : void 0;
 /** The fenced-code block start: three or more backticks or tildes. */
@@ -22,5 +22,4 @@ const fencedCodeStart = {
 	}
 };
 
-//#endregion
 export { fencedCodeStart };

package/internal/blocks/footnoteDefinition.js

@@ -3,7 +3,7 @@ import { flowChildren } from "../blockTypes.js";
 import { stickyOf } from "../patterns.js";
 import { normalizeLabelText } from "../references.js";
 
-//#region src/internal/blocks/footnoteDefinition.ts
+// src/internal/blocks/footnoteDefinition.ts
 /**
 * `_scan_footnote_definition` from `src/scanners.re`:
 *
@@ -80,5 +80,4 @@ const footnoteDefinitionStart = {
 	}
 };
 
-//#endregion
 export { footnoteDefinitionConstruct, footnoteDefinitionStart };

package/internal/blocks/frontmatter.js

@@ -1,4 +1,4 @@
-//#region src/internal/blocks/frontmatter.ts
+// src/internal/blocks/frontmatter.ts
 const FENCES = /* @__PURE__ */ new Map([
 	["---", {
 		format: "yaml",
@@ -98,5 +98,4 @@ const scanRawFrontmatter = (source) => {
 	return null;
 };
 
-//#endregion
 export { scanFrontmatter, scanRawFrontmatter };

package/internal/blocks/htmlBlock.js

@@ -2,7 +2,7 @@ import { Html } from "../../MarkdownNode.js";
 import { peekCode } from "../preprocess.js";
 import { CLOSETAG, OPENTAG } from "../htmlTags.js";
 
-//#region src/internal/blocks/htmlBlock.ts
+// src/internal/blocks/htmlBlock.ts
 const C_LESSTHAN = 60;
 const reHtmlBlockOpen = [
 	/./,
@@ -68,5 +68,4 @@ const htmlBlockStart = {
 	}
 };
 
-//#endregion
 export { htmlBlockConstruct, htmlBlockStart, isHtmlBlockEnd };

package/internal/blocks/indentedCode.js

@@ -1,4 +1,4 @@
-//#region src/internal/blocks/indentedCode.ts
+// src/internal/blocks/indentedCode.ts
 /** The indented-code block start: four columns of indentation. */
 const indentedCodeStart = {
 	name: "indentedCode",
@@ -12,5 +12,4 @@ const indentedCodeStart = {
 	}
 };
 
-//#endregion
 export { indentedCodeStart };

package/internal/blocks/linkReferenceDefinition.js

@@ -3,7 +3,7 @@ import { makeBlockNode } from "../blockTypes.js";
 import { parseReference } from "../references.js";
 import { sliceWithSegments, sourceOffsetAt } from "../segments.js";
 
-//#region src/internal/blocks/linkReferenceDefinition.ts
+// src/internal/blocks/linkReferenceDefinition.ts
 const C_OPEN_BRACKET = 91;
 /**
 * Split every leading link reference definition out of `block`, inserting one
@@ -68,5 +68,4 @@ const definitionConstruct = {
 	}
 };
 
-//#endregion
 export { definitionConstruct, extractDefinitions };

package/internal/blocks/list.js

@@ -2,7 +2,7 @@ import { List, ListItem } from "../../MarkdownNode.js";
 import { flowChildren, listItemChildren } from "../blockTypes.js";
 import { isSpaceOrTab, peekCode } from "../preprocess.js";
 
-//#region src/internal/blocks/list.ts
+// src/internal/blocks/list.ts
 const reBulletListMarker = /^[*+-]/;
 const reOrderedListMarker = /^(\d{1,9})([.)])/;
 const reNonSpace = /[^ \t\f\v\r\n]/;
@@ -155,5 +155,4 @@ const listItemStart = {
 	}
 };
 
-//#endregion
 export { listConstruct, listItemConstruct, listItemStart };

package/internal/blocks/paragraph.js

@@ -1,7 +1,7 @@
 import { Paragraph } from "../../MarkdownNode.js";
 import { extractDefinitions } from "./linkReferenceDefinition.js";
 
-//#region src/internal/blocks/paragraph.ts
+// src/internal/blocks/paragraph.ts
 /** Paragraph: absorbs lines until a blank one, and contains nothing. */
 const paragraphConstruct = {
 	type: "paragraph",
@@ -23,5 +23,4 @@ const paragraphConstruct = {
 	}
 };
 
-//#endregion
 export { paragraphConstruct };

package/internal/blocks/setextHeading.js

@@ -1,6 +1,6 @@
 import { extractDefinitions } from "./linkReferenceDefinition.js";
 
-//#region src/internal/blocks/setextHeading.ts
+// src/internal/blocks/setextHeading.ts
 const reSetextHeadingLine = /^(?:=+|-+)[ \t]*$/;
 /** The setext heading block start: a run of `=` or `-` under a paragraph. */
 const setextHeadingStart = {
@@ -20,5 +20,4 @@ const setextHeadingStart = {
 	}
 };
 
-//#endregion
 export { setextHeadingStart };

package/internal/blocks/table.js

@@ -3,7 +3,7 @@ import { tableCellChildren, tableRowChildren } from "../blockTypes.js";
 import { ESCAPABLE } from "../unescape.js";
 import { sliceWithSegments } from "../segments.js";
 
-//#region src/internal/blocks/table.ts
+// src/internal/blocks/table.ts
 /**
 * Upstream's `MAX_AUTOCOMPLETED_CELLS`: the ceiling on cells the parser
 * invents to pad short rows, which is what stops a wide header followed by a
@@ -374,5 +374,4 @@ const tableCellConstruct = {
 	}
 };
 
-//#endregion
 export { tableCellConstruct, tableConstruct, tableHeaderStart, tableRowConstruct, tableRowStart };

package/internal/blocks/taskListItem.js

@@ -1,4 +1,4 @@
-//#region src/internal/blocks/taskListItem.ts
+// src/internal/blocks/taskListItem.ts
 /**
 * `_scan_tasklist`, as the generated scanner accepts it.
 *
@@ -32,5 +32,4 @@ const taskListItemStart = {
 	}
 };
 
-//#endregion
 export { taskListItemStart };

package/internal/blocks/thematicBreak.js

@@ -1,6 +1,6 @@
 import { ThematicBreak } from "../../MarkdownNode.js";
 
-//#region src/internal/blocks/thematicBreak.ts
+// src/internal/blocks/thematicBreak.ts
 const reThematicBreak = /^(?:\*[ \t]*){3,}$|^(?:_[ \t]*){3,}$|^(?:-[ \t]*){3,}$/;
 const markerCharOf = (char) => char === "-" || char === "_" || char === "*" ? char : void 0;
 /** Thematic break: one line, no children. */
@@ -31,5 +31,4 @@ const thematicBreakStart = {
 	}
 };
 
-//#endregion
 export { thematicBreakConstruct, thematicBreakStart };

package/internal/carriers.js

@@ -1,4 +1,4 @@
-//#region src/internal/carriers.ts
+// src/internal/carriers.ts
 /**
 * The engine's error-code vocabulary: currently exactly one, the
 * hardening-guard trip. Widens as new parse-error kinds are added.
@@ -38,5 +38,4 @@ var GuardExceeded = class extends Error {
 /** Narrows `unknown` to {@link GuardExceeded}; never a bare `instanceof` at a call site. */
 const isGuardExceeded = (u) => u instanceof GuardExceeded;
 
-//#endregion
 export { GuardExceeded, MARKDOWN_PARSE_ERROR_CODES, RawMarkdownError, isGuardExceeded, isRawMarkdownError };

package/internal/entities.js

@@ -1,6 +1,6 @@
 import { ENTITY_MAP } from "./entityMap.js";
 
-//#region src/internal/entities.ts
+// src/internal/entities.ts
 /** The largest code point Unicode defines. */
 const MAX_CODE_POINT = 1114111;
 /**
@@ -22,5 +22,4 @@ const decodeEntity = (entity) => {
 	return String.fromCodePoint(code);
 };
 
-//#endregion
 export { decodeEntity };