@readme/markdown 15.8.0 → 15.9.1

package/dist/processor/transform/mdxish/components/utils.d.ts

@@ -10,13 +10,6 @@ export type MdxAttributes = (MdxJsxAttribute | MdxJsxExpressionAttribute)[];
 export declare const getInlineMdProcessor: ({ safeMode }?: {
     safeMode?: boolean;
 }) => import("unified").Processor<import("mdast").Root, undefined, undefined, undefined, undefined>;
-/**
- * Mark re-parsed subtree roots with the string their positions index into, so consumers
- * slicing by offset use the right source (see `Data.reparseSource`). Only roots are
- * stamped; descendants resolve via their nearest stamped ancestor. Roots a deeper
- * re-parse already stamped keep their own string.
- */
-export declare const stampReparseSource: (roots: Node[], reparseSource: string) => void;
 /**
  * True when a tag name starts with an uppercase letter — ReadMe's marker for
  * a custom MDX component (vs a lowercase HTML tag).

package/dist/processor/transform/mdxish/reparse-source.d.ts

@@ -0,0 +1,18 @@
+import type { Node, Parent } from 'mdast';
+/**
+ * Mark re-parsed subtree roots with the string their positions index into, so consumers
+ * slicing by offset use the right source (see `Data.reparseSource`). Only roots are
+ * stamped; descendants resolve via their nearest stamped ancestor. Roots a deeper
+ * re-parse already stamped keep their own string.
+ */
+export declare const stampReparseSource: (roots: Node[], reparseSource: string) => void;
+/**
+ * Splice `replacements` over `parent.children[index]`. They take over the replaced node's
+ * position, so they also take over the coordinate space that position indexes into.
+ */
+export declare const replaceInheritingReparseSource: (parent: Parent, index: number, replacements: Node[]) => void;
+/**
+ * The string `node`'s offsets index into: the nearest stamp on it or an ancestor, else the
+ * document source.
+ */
+export declare const resolveReparseSource: (node: Node, ancestors: Node[], documentSource?: string) => string;

package/dist/processor/transform/mdxish/tables/cell-style.d.ts

@@ -0,0 +1,7 @@
+import type { MdxJsxAttribute } from 'mdast-util-mdx-jsx';
+type CellAlign = 'center' | 'left' | 'right' | null;
+/** `left` is the browser default, so it's omitted. Lowercase tables get the HTML string form. */
+export declare const cellStyle: (align: CellAlign, width?: string | null, { html }?: {
+    html?: boolean;
+}) => MdxJsxAttribute | null;
+export {};

package/dist/processor/transform/mdxish/tables/cell-width.d.ts

@@ -0,0 +1,9 @@
+import type { MdxJsxFlowElement, MdxJsxTextElement } from 'mdast-util-mdx-jsx';
+/** Bare numbers are pixels. A value carrying declaration separators is not a single width. */
+export declare const normalizeWidth: (value: unknown) => string | null;
+/** Handles a CSS declaration list and a style object safe mode left as a string (`{ width: "30%" }`). */
+export declare const widthFromStyleString: (style: string) => string | undefined;
+/** Accepts `style={{ width }}`, `style="width: …"` and the hand-authored `width="…"`. */
+export declare const getCellWidth: (cell: MdxJsxFlowElement | MdxJsxTextElement) => string | null;
+/** True when the cell's attributes state nothing but its width, which mdast can carry. */
+export declare const hasOnlyWidthAttributes: (cell: MdxJsxFlowElement | MdxJsxTextElement) => boolean;

package/dist/processor/transform/mdxish/tables/mdxish-tables.d.ts

@@ -1,4 +1,5 @@
-import type { Transform } from 'mdast-util-from-markdown';
+import type { Root } from 'mdast';
+import type { Plugin } from 'unified';
 /**
  * Converts JSX Table elements to markdown table nodes and re-parses markdown in cells.
  *
@@ -10,5 +11,5 @@ import type { Transform } from 'mdast-util-from-markdown';
  * When cell content contains block-level nodes (callouts, code blocks, etc.), the table
  * is kept as a JSX <Table> element so that remarkRehype can properly handle the flow content.
  */
-declare const mdxishTables: () => Transform;
+declare const mdxishTables: Plugin<[], Root>;
 export default mdxishTables;

package/dist/processor/transform/mdxish/tables/split-nested-tables.d.ts

@@ -6,6 +6,7 @@ import type { Html } from 'mdast';
  * The surrounding raw HTML (the wrapper's open/close tags) would be re-nested
  * around the parsed tables by rehype-raw.
  *
- * Returns null when there is no wrapped table to extract.
+ * Returns null when there is no wrapped table to extract. `source` is the string the node's
+ * positions index into, so the parts' positions survive stripped container prefixes.
  */
-export declare const splitHtmlWithNestedTables: (node: Html) => Html[] | null;
+export declare const splitHtmlWithNestedTables: (node: Html, source?: string) => Html[] | null;

package/dist/processor/utils.d.ts

@@ -2,7 +2,7 @@ import type { Root as HastRoot } from 'hast';
 import type { Node, Root as MdastRoot, Root } from 'mdast';
 import type { MdxJsxFlowElement, MdxJsxTextElement, MdxjsEsm } from 'mdast-util-mdx';
 import type { MdxJsxAttribute } from 'mdast-util-mdx-jsx';
-import type { Point } from 'unist';
+import type { Point, Position } from 'unist';
 import { jsxAcornParser } from '../lib/utils/jsx-acorn-parser';
 export { jsxAcornParser };
 /**
@@ -22,11 +22,10 @@ export { jsxAcornParser };
  */
 export declare function evaluate(source: string, scope?: Record<string, unknown>): any;
 /**
- * Advance a `Point` by the `consumed` substring that follows it, returning the
- * point at the consumed string's end. Lets split-out sub-nodes carry accurate
- * document positions so downstream offset shifting stays correct.
+ * Maps offsets in a node's `value` to points in `source`. Containers strip a prefix from every
+ * continuation line of `value`, so a plain offset shift drifts by line (CX-4028).
  */
-export declare const pointAfter: (start: Point, consumed: string) => Point;
+export declare const createValueToSourceMapper: (position: Position | undefined, value: string, source: string | null | undefined) => ((valueOffset: number) => Point) | null;
 /**
  * Formats the hProperties of a node as a string, so they can be compiled back into JSX/MDX.
  * This currently sets all the values to a string since we process/compile the MDX on the fly