satteri 0.11.1 → 0.11.4

package/dist/compile-options.js

@@ -1,4 +1,4 @@
-import { ENABLE_DEFINITION_LIST, ENABLE_DIRECTIVE, ENABLE_FOOTNOTES, ENABLE_GFM, ENABLE_HEADING_ATTRIBUTES, ENABLE_MATH, ENABLE_MATH_MULTI_DOLLAR, ENABLE_PLUSES_DELIMITED_METADATA_BLOCKS, ENABLE_SMART_DASHES, ENABLE_SMART_ELLIPSES, ENABLE_SMART_PUNCTUATION, ENABLE_SMART_QUOTES, ENABLE_STRIKETHROUGH, ENABLE_SUBSCRIPT, ENABLE_SUPERSCRIPT, ENABLE_TABLES, ENABLE_TASKLISTS, ENABLE_WIKILINKS, ENABLE_YAML_STYLE_METADATA_BLOCKS, } from "./generated/parse-options.js";
+import { ENABLE_ATTRIBUTES, ENABLE_DEFINITION_LIST, ENABLE_DIRECTIVE, ENABLE_FOOTNOTES, ENABLE_GFM, ENABLE_HEADING_ATTRIBUTES, ENABLE_MATH, ENABLE_MATH_MULTI_DOLLAR, ENABLE_PLUSES_DELIMITED_METADATA_BLOCKS, ENABLE_SMART_DASHES, ENABLE_SMART_ELLIPSES, ENABLE_SMART_PUNCTUATION, ENABLE_SMART_QUOTES, ENABLE_STRIKETHROUGH, ENABLE_SUBSCRIPT, ENABLE_SUPERSCRIPT, ENABLE_TABLES, ENABLE_TASKLISTS, ENABLE_WIKILINKS, ENABLE_YAML_STYLE_METADATA_BLOCKS, } from "./generated/parse-options.js";
 const GFM_PARSE_OPTIONS = ENABLE_TABLES | ENABLE_STRIKETHROUGH | ENABLE_TASKLISTS | ENABLE_GFM;
 const FRONTMATTER_PARSE_OPTIONS = ENABLE_YAML_STYLE_METADATA_BLOCKS | ENABLE_PLUSES_DELIMITED_METADATA_BLOCKS;
 export const DEFAULT_PARSE_OPTIONS = GFM_PARSE_OPTIONS | ENABLE_FOOTNOTES | FRONTMATTER_PARSE_OPTIONS;
@@ -24,6 +24,8 @@ function featuresToParseOptions(features) {
     }
     if (features.headingAttributes)
         options |= ENABLE_HEADING_ATTRIBUTES;
+    if (features.attributes)
+        options |= ENABLE_ATTRIBUTES;
     if (features.directive)
         options |= ENABLE_DIRECTIVE;
     if (features.superscript)

package/dist/compile-types.d.ts

@@ -102,8 +102,20 @@ export interface Features {
      * ```
      */
     math?: boolean | MathOptions;
-    /** Heading attributes (`# text { #id .class }`). Default: false. */
+    /**
+     * Heading attributes (`# text { #id .class }`). Default: false.
+     *
+     * @deprecated Use {@link Features.attributes}, which reads heading attributes
+     * as well as attributes on other elements.
+     */
     headingAttributes?: boolean;
+    /**
+     * Curly-brace attributes (`{#id .class key=value}`) on fenced code blocks
+     * (` ```js {.class} `), inline elements (`*em*{.class}`), and paragraphs,
+     * list items, lists, blockquotes, tables, table cells and thematic breaks,
+     * as well as on headings. Default: false.
+     */
+    attributes?: boolean;
     /** Colon-delimited container directive blocks (`:::`). Default: false. */
     directive?: boolean;
     /** Superscript (`^super^`). Default: false. */

package/dist/compile.js

@@ -10,8 +10,8 @@ import { MdastReader } from "./mdast/mdast-reader.js";
 import { normalizePlugins } from "./plugin.js";
 export function markdownToHtml(source, options = {}) {
     const { features, fileURL, data = {} } = options;
-    const mdastPlugins = normalizePlugins(options.mdastPlugins ?? [], "mdastPlugins", source, fileURL, "markdown", data);
-    const hastPlugins = normalizePlugins(options.hastPlugins ?? [], "hastPlugins", source, fileURL, "markdown", data);
+    const mdastPlugins = normalizePlugins(options.mdastPlugins ?? [], "mdastPlugins", source, fileURL, "markdown", data, features);
+    const hastPlugins = normalizePlugins(options.hastPlugins ?? [], "hastPlugins", source, fileURL, "markdown", data, features);
     const hastMayHaveStubs = hastPlugins.length > 0;
     const { parseOptions, convertOptions: nativeConvertOptions } = featuresToNative(features);
     // Without plugins, one NAPI call avoids the handle lifecycle’s extra boundary crossings.
@@ -102,8 +102,8 @@ export function markdownToJs(source, options = {}) {
 function toJsImpl(source, options, mdx) {
     const { mdastPlugins: mdastInput = [], hastPlugins: hastInput = [], features, fileURL, data = {}, ...mdxFields } = options;
     const sourceFormat = mdx ? "mdx" : "markdown";
-    const mdastPlugins = normalizePlugins(mdastInput, "mdastPlugins", source, fileURL, sourceFormat, data);
-    const hastPlugins = normalizePlugins(hastInput, "hastPlugins", source, fileURL, sourceFormat, data);
+    const mdastPlugins = normalizePlugins(mdastInput, "mdastPlugins", source, fileURL, sourceFormat, data, features);
+    const hastPlugins = normalizePlugins(hastInput, "hastPlugins", source, fileURL, sourceFormat, data, features);
     const hastMayHaveStubs = hastPlugins.length > 0;
     const mdxOptions = mdxOptionsToNative(mdxFields);
     const { parseOptions, convertOptions: nativeConvertOptions } = featuresToNative(features);
@@ -239,7 +239,7 @@ function applyCollectedHastCommands(handle, collected, invalidateStubs) {
 function toMdastImpl(source, options, mdx) {
     const { features, fileURL, data = {} } = options;
     const sourceFormat = mdx ? "mdx" : "markdown";
-    const mdastPlugins = normalizePlugins(options.mdastPlugins ?? [], "mdastPlugins", source, fileURL, sourceFormat, data);
+    const mdastPlugins = normalizePlugins(options.mdastPlugins ?? [], "mdastPlugins", source, fileURL, sourceFormat, data, features);
     const { parseOptions } = featuresToNative(features);
     if (mdastPlugins.length === 0) {
         const wire = parseMdastWire(source, parseOptions, mdx, options.position);
@@ -268,8 +268,8 @@ function toMdastImpl(source, options, mdx) {
 function toHastImpl(source, options, mdx) {
     const { features, fileURL, data = {} } = options;
     const sourceFormat = mdx ? "mdx" : "markdown";
-    const mdastPlugins = normalizePlugins(options.mdastPlugins ?? [], "mdastPlugins", source, fileURL, sourceFormat, data);
-    const hastPlugins = normalizePlugins(options.hastPlugins ?? [], "hastPlugins", source, fileURL, sourceFormat, data);
+    const mdastPlugins = normalizePlugins(options.mdastPlugins ?? [], "mdastPlugins", source, fileURL, sourceFormat, data, features);
+    const hastPlugins = normalizePlugins(options.hastPlugins ?? [], "hastPlugins", source, fileURL, sourceFormat, data, features);
     const { parseOptions, convertOptions } = featuresToNative(features);
     if (mdastPlugins.length === 0 && hastPlugins.length === 0) {
         const wire = parseHastWire(source, parseOptions, convertOptions, mdx, options.position);

package/dist/generated/parse-options.d.ts

@@ -17,3 +17,4 @@ export declare const ENABLE_SMART_QUOTES: number;
 export declare const ENABLE_SMART_DASHES: number;
 export declare const ENABLE_SMART_ELLIPSES: number;
 export declare const ENABLE_MATH_MULTI_DOLLAR: number;
+export declare const ENABLE_ATTRIBUTES: number;

package/dist/generated/parse-options.js

@@ -18,3 +18,4 @@ export const ENABLE_SMART_QUOTES = 1 << 18;
 export const ENABLE_SMART_DASHES = 1 << 19;
 export const ENABLE_SMART_ELLIPSES = 1 << 20;
 export const ENABLE_MATH_MULTI_DOLLAR = 1 << 23;
+export const ENABLE_ATTRIBUTES = 1 << 24;

package/dist/generated/wire-constants.d.ts

@@ -9,6 +9,7 @@ export declare const OP_BOOL = 8;
 export declare const OP_DATA = 9;
 export declare const OP_PROP = 10;
 export declare const OP_ALIGN = 11;
+export declare const OP_POSITION = 12;
 export declare const OF_VALUE = 0;
 export declare const OF_URL = 1;
 export declare const OF_TITLE = 2;

package/dist/generated/wire-constants.js

@@ -10,6 +10,7 @@ export const OP_BOOL = 0x08;
 export const OP_DATA = 0x09;
 export const OP_PROP = 0x0a;
 export const OP_ALIGN = 0x0b;
+export const OP_POSITION = 0x0c;
 export const OF_VALUE = 0;
 export const OF_URL = 1;
 export const OF_TITLE = 2;

package/dist/hast/hast-visitor.js

@@ -126,6 +126,9 @@ function emitHastOp(w, node, isRoot, refs, document = false, allowRootRef = fals
     if (document && n.type.startsWith("mdx"))
         return true;
     w.open(type);
+    // A standalone document is only serialized, and has no source for a position to point into.
+    if (!document)
+        w.position(n.position);
     if (type === HAST_ELEMENT) {
         w.str(OF_TAGNAME, typeof n.tagName === "string" ? n.tagName : "div");
         const props = n.properties;

package/dist/mdast/mdast-visitor.js

@@ -393,6 +393,7 @@ function emitMdastOp(w, node, isRoot, forReplace, refs, allowRootRef = false) {
         isCustom = true;
     }
     w.open(type);
+    w.position(n.position);
     if (isCustom)
         w.str(OF_NAME, n.type);
     if (typeof n.value === "string")

package/dist/op-stream.d.ts

@@ -13,5 +13,8 @@ export declare class OpWriter extends ByteWriter {
     ref(id: number): void;
     align(codes: readonly number[]): void;
     keepChildren(): void;
+    /** Write a node's `position` so the node keeps it. Only lines and columns are
+     *  sent: Rust derives the byte offsets the arena stores from them. */
+    position(value: unknown): void;
 }
 export declare function emitMdxAttr(w: OpWriter, a: Record<string, unknown>): void;

package/dist/op-stream.js

@@ -1,6 +1,6 @@
 // Writing directly into CommandBuffer avoids an intermediate op-stream allocation and copy.
 import { ByteWriter } from "./byte-writer.js";
-import { OP_OPEN, OP_CLOSE, OP_REF, OP_KEEP_CHILDREN, OP_STR, OP_U8, OP_U32, OP_BOOL, OP_DATA, OP_PROP, OP_ALIGN, MDX_ATTR_BOOLEAN_PROP, MDX_ATTR_LITERAL_PROP, MDX_ATTR_EXPRESSION_PROP, MDX_ATTR_SPREAD, } from "./generated/wire-constants.js";
+import { OP_OPEN, OP_CLOSE, OP_REF, OP_KEEP_CHILDREN, OP_STR, OP_U8, OP_U32, OP_BOOL, OP_DATA, OP_PROP, OP_ALIGN, OP_POSITION, MDX_ATTR_BOOLEAN_PROP, MDX_ATTR_LITERAL_PROP, MDX_ATTR_EXPRESSION_PROP, MDX_ATTR_SPREAD, } from "./generated/wire-constants.js";
 export { OF_VALUE, OF_URL, OF_TITLE, OF_ALT, OF_LANG, OF_META, OF_IDENTIFIER, OF_LABEL, OF_NAME, OF_REFERENCE_TYPE, OF_DEPTH, OF_CHECKED, OF_START, OF_ORDERED, OF_SPREAD, OF_TAGNAME, OF_EXPLICIT, PROP_STRING, PROP_BOOL_TRUE, PROP_BOOL_FALSE, PROP_SPACE_SEP, PROP_INT, PROP_NULL, PROP_TOKEN_LIST, } from "./generated/wire-constants.js";
 export class OpWriter extends ByteWriter {
     constructor(initialSize = 512) {
@@ -73,6 +73,33 @@ export class OpWriter extends ByteWriter {
         this.ensure(1);
         this.buf[this.n++] = OP_KEEP_CHILDREN;
     }
+    /** Write a node's `position` so the node keeps it. Only lines and columns are
+     *  sent: Rust derives the byte offsets the arena stores from them. */
+    position(value) {
+        // Most re-encoded nodes are built by plugins and have no position: return before any work.
+        if (value == null)
+            return;
+        const { start, end } = value;
+        if (start == null || end == null)
+            return;
+        const { line: startLine, column: startColumn } = start;
+        const { line: endLine, column: endColumn } = end;
+        if (!isLineOrColumn(startLine) ||
+            !isLineOrColumn(startColumn) ||
+            !isLineOrColumn(endLine) ||
+            !isLineOrColumn(endColumn)) {
+            return;
+        }
+        this.ensure(17);
+        this.buf[this.n++] = OP_POSITION;
+        this.writeU32(startLine);
+        this.writeU32(startColumn);
+        this.writeU32(endLine);
+        this.writeU32(endColumn);
+    }
+}
+function isLineOrColumn(value) {
+    return Number.isInteger(value) && value >= 1 && value <= 4294967295;
 }
 export function emitMdxAttr(w, a) {
     if (a.type === "mdxJsxExpressionAttribute") {

package/dist/plugin.d.ts

@@ -1,5 +1,6 @@
 import type { MdastPluginInstance } from "./mdast/mdast-visitor.js";
 import type { HastVisitorInstance } from "./hast/hast-visitor.js";
+import type { Features } from "./compile-types.js";
 import type { Data, SourceFormat } from "./types.js";
 /**
  * What a plugin factory is told about the document, before it is parsed.
@@ -17,6 +18,10 @@ export interface PluginFactoryContext {
     readonly source: string;
     /** The document-level data bag, before any plugin has run. */
     readonly data: Data;
+    /** The `features` compile option, or `{}` (the defaults) when none was
+     *  given. Pass it on to compile a fragment with the same syntax as the
+     *  document. */
+    readonly features: Features;
 }
 type RequireAtLeastOne<T, K extends keyof T> = Omit<T, K> & {
     [P in K]-?: Required<Pick<T, P>> & Partial<Pick<T, Exclude<K, P>>>;
@@ -41,7 +46,7 @@ export type MdastPluginInput = MdastPluginEntry;
 /** Alias for {@link HastPluginEntry}. */
 export type HastPluginInput = HastPluginEntry;
 /** Resolve nested entries and invoke each factory once per compile. */
-export declare function normalizePlugins<D>(entries: readonly PluginEntry<D>[], option: string, source: string, fileURL: URL | undefined, sourceFormat: SourceFormat, data: Data): D[];
+export declare function normalizePlugins<D>(entries: readonly PluginEntry<D>[], option: string, source: string, fileURL: URL | undefined, sourceFormat: SourceFormat, data: Data, features?: Features): D[];
 export declare function defineMdastPlugin<P extends MdastPluginDefinition>(definition: P): P;
 export declare function defineHastPlugin<P extends HastPluginDefinition>(definition: P): P;
 export {};

package/dist/plugin.js

@@ -1,7 +1,7 @@
 // Bound recursive factories so a self-referential preset cannot overflow the stack.
 const MAX_FACTORY_DEPTH = 10;
 /** Resolve nested entries and invoke each factory once per compile. */
-export function normalizePlugins(entries, option, source, fileURL, sourceFormat, data) {
+export function normalizePlugins(entries, option, source, fileURL, sourceFormat, data, features) {
     const out = [];
     // Built lazily so a list with no factories allocates no context.
     let ctx;
@@ -25,6 +25,7 @@ export function normalizePlugins(entries, option, source, fileURL, sourceFormat,
                 // The parser drops a leading BOM, so `ctx.source` in a visitor lacks it too.
                 source: source.startsWith("\uFEFF") ? source.slice(1) : source,
                 data,
+                features: features ?? {},
             });
             walk(entry(ctx), factoryDepth - 1);
             return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "satteri",
-  "version": "0.11.1",
+  "version": "0.11.4",
   "description": "High-performance Markdown and MDX processing",
   "license": "MIT",
   "repository": {
@@ -43,11 +43,14 @@
     "@emnapi/runtime": "^1.11.1",
     "@mdx-js/mdx": "^3.1.1",
     "@napi-rs/wasm-runtime": "^1.1.5",
+    "@types/markdown-it": "^14.2.0",
     "@types/node": "^26.2.0",
     "@types/react": "^19.2.18",
     "@types/react-dom": "^19.2.4",
     "fast-check": "^4.7.0",
     "hastscript": "^9.0.1",
+    "markdown-it": "^15.0.2",
+    "markdown-it-attrs": "^5.0.1",
     "mdast-util-mdx": "^3.0.0",
     "mdast-util-to-hast": "^13.2.1",
     "react": "^19.2.5",