@elastic/isomer-sdk 0.0.0 → 0.2.0

package/dist/render/html/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/render/html/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EACL,KAAK,2BAA2B,EAChC,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,wBAAwB,GACzB,MAAM,YAAY,CAAC"}

package/dist/render/html/index.js

@@ -0,0 +1,8 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+export { renderHTMLWithDispatcher, } from './envelope.js';
+//# sourceMappingURL=index.js.map

package/dist/render/html/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/render/html/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAOL,wBAAwB,GACzB,MAAM,YAAY,CAAC","sourcesContent":["/*\n * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one\n * or more contributor license agreements. Licensed under the Elastic License\n * 2.0; you may not use this file except in compliance with the Elastic License\n * 2.0.\n */\n\nexport { type EnhancementDefinition } from './enhancements';\nexport {\n  type HTMLDispatcherRenderOptions,\n  type HTMLEnhancementScope,\n  type HTMLRenderDispatcher,\n  type HTMLRenderOptions,\n  type HTMLRenderResult,\n  type HTMLStyleAdapter,\n  renderHTMLWithDispatcher,\n} from './envelope';\n"]}

package/dist/render/index.d.ts

@@ -0,0 +1,6 @@
+export { LAYOUT_ROOM_ATTRIBUTE, NODE_ANCHOR_ATTRIBUTE, layoutRoom, nodeAnchor, withNodeAnchors, withoutAnchors, } from './anchors.js';
+export { type FormatDisplayValueOptions, formatDisplayValue, isStructuredValue, rawDisplayValue, } from './format_display_value.js';
+export { type LayoutBox, type LayoutFinding, type LayoutRect, checkLayout, } from './layout_check.js';
+export { type PayloadMeasurement } from './payload.js';
+export { type PrimitiveDispatcher, type PrimitiveDispatcherOptions, createPrimitiveDispatcher, } from './primitive_dispatch.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/render/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/render/index.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,UAAU,EACV,UAAU,EACV,eAAe,EACf,cAAc,GACf,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,KAAK,yBAAyB,EAC9B,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,GAChB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,WAAW,GACZ,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,0BAA0B,EAC/B,yBAAyB,GAC1B,MAAM,sBAAsB,CAAC"}

package/dist/render/index.js

@@ -0,0 +1,11 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+export { LAYOUT_ROOM_ATTRIBUTE, NODE_ANCHOR_ATTRIBUTE, layoutRoom, nodeAnchor, withNodeAnchors, withoutAnchors, } from './anchors.js';
+export { formatDisplayValue, isStructuredValue, rawDisplayValue, } from './format_display_value.js';
+export { checkLayout, } from './layout_check.js';
+export { createPrimitiveDispatcher, } from './primitive_dispatch.js';
+//# sourceMappingURL=index.js.map

package/dist/render/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/render/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,UAAU,EACV,UAAU,EACV,eAAe,EACf,cAAc,GACf,MAAM,WAAW,CAAC;AACnB,OAAO,EAEL,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,GAChB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAIL,WAAW,GACZ,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAGL,yBAAyB,GAC1B,MAAM,sBAAsB,CAAC","sourcesContent":["/*\n * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one\n * or more contributor license agreements. Licensed under the Elastic License\n * 2.0; you may not use this file except in compliance with the Elastic License\n * 2.0.\n */\n\nexport {\n  LAYOUT_ROOM_ATTRIBUTE,\n  NODE_ANCHOR_ATTRIBUTE,\n  layoutRoom,\n  nodeAnchor,\n  withNodeAnchors,\n  withoutAnchors,\n} from './anchors';\nexport {\n  type FormatDisplayValueOptions,\n  formatDisplayValue,\n  isStructuredValue,\n  rawDisplayValue,\n} from './format_display_value';\nexport {\n  type LayoutBox,\n  type LayoutFinding,\n  type LayoutRect,\n  checkLayout,\n} from './layout_check';\nexport { type PayloadMeasurement } from './payload';\nexport {\n  type PrimitiveDispatcher,\n  type PrimitiveDispatcherOptions,\n  createPrimitiveDispatcher,\n} from './primitive_dispatch';\n"]}

package/dist/render/layout_check.d.ts

@@ -0,0 +1,43 @@
+import type { ChildNodeWalker } from '../composition/body_node_base.js';
+/** A rectangle on the canvas, in pixels. */
+export interface LayoutRect {
+    readonly x: number;
+    readonly y: number;
+    readonly width: number;
+    readonly height: number;
+}
+/** A laid-out element and the elements nested in it, as a layout engine measures them. */
+export interface LayoutBox extends LayoutRect {
+    /** Absent means unscaled. */
+    readonly scale?: number;
+    /** Text laid out in the box. */
+    readonly runs?: readonly LayoutRect[];
+    /** Where a {@link NODE_ANCHOR_ATTRIBUTE} is read from. */
+    readonly attributes?: Readonly<Record<string, string>>;
+    readonly children: readonly LayoutBox[];
+}
+/** A node drawn past the room its container gives it, or onto a sibling, by `by` pixels. */
+export interface LayoutFinding {
+    kind: 'overflow' | 'overlap';
+    /** In validation's form, e.g. `body[1].items[0]`. */
+    path: string;
+    type: string;
+    /** The sibling an `overlap` lands on. */
+    with?: {
+        path: string;
+        type: string;
+    };
+    by: number;
+}
+/**
+ * Where the nodes of `body` run past their room or onto each other in
+ * `layout`, a measured render on `surface` with node anchors on. Empty when
+ * nothing does.
+ *
+ * A node's room is the box of its nearest anchored or `layoutRoom` ancestor,
+ * or `layout` at the top level, and only siblings under one room are
+ * compared. Nothing inside a scaled box is checked. A finding is advice, not an error:
+ * an overlap may be intended.
+ */
+export declare const checkLayout: (layout: LayoutBox, body: readonly unknown[], walk: ChildNodeWalker, surface: "react" | "snapshot") => LayoutFinding[];
+//# sourceMappingURL=layout_check.d.ts.map

package/dist/render/layout_check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout_check.d.ts","sourceRoot":"","sources":["../../src/render/layout_check.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAUrE,4CAA4C;AAC5C,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,0FAA0F;AAC1F,MAAM,WAAW,SAAU,SAAQ,UAAU;IAC3C,6BAA6B;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,gCAAgC;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IACtC,0DAA0D;IAC1D,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACvD,QAAQ,CAAC,QAAQ,EAAE,SAAS,SAAS,EAAE,CAAC;CACzC;AAED,4FAA4F;AAC5F,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,UAAU,GAAG,SAAS,CAAC;IAC7B,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,IAAI,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACtC,EAAE,EAAE,MAAM,CAAC;CACZ;AAqFD;;;;;;;;;GASG;AACH,eAAO,MAAM,WAAW,GACtB,QAAQ,SAAS,EACjB,MAAM,SAAS,OAAO,EAAE,EACxB,MAAM,eAAe,EACrB,SAAS,OAAO,GAAG,UAAU,KAC5B,aAAa,EAgFf,CAAC"}

package/dist/render/layout_check.js

@@ -0,0 +1,129 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+import { anchoredNodePaths, LAYOUT_ROOM_ATTRIBUTE, NODE_ANCHOR_ATTRIBUTE, nodeType, pairAnchors, } from './anchors.js';
+// Sub-pixel rounding reads as overflow without it.
+const tolerance = 1;
+const isScaled = ({ scale = 1 }) => Math.abs(scale - 1) > 0.001;
+const hasArea = ({ width, height }) => width > 0 && height > 0;
+/** Every anchored box, pre-order, including those inside a scaled box, so a type's count matches its nodes. */
+const anchoredBoxes = (box) => {
+    const value = box.attributes?.[NODE_ANCHOR_ATTRIBUTE];
+    return [
+        ...(value === undefined ? [] : [[value, box]]),
+        ...box.children.flatMap(anchoredBoxes),
+    ];
+};
+const roomBoxes = (box) => [
+    ...(box.attributes?.[LAYOUT_ROOM_ATTRIBUTE] === undefined ? [] : [box]),
+    ...box.children.flatMap(roomBoxes),
+];
+/**
+ * The element boxes a node's own content fills: its box and those under it,
+ * down to the nodes nested in it. Text runs are left out because glyphs
+ * overhang a tight line height; a scaled box counts as itself alone.
+ */
+const ownBoxes = (box, nested) => [
+    box,
+    ...(isScaled(box)
+        ? []
+        : box.children.flatMap((child) => nested.has(child) ? [] : ownBoxes(child, nested))),
+];
+/** What a box paints: its text, or itself when it holds nothing else, like a dot or a rule. */
+const painted = (box) => {
+    if (isScaled(box)) {
+        return [box];
+    }
+    const own = box.runs && box.runs.length > 0
+        ? box.runs
+        : box.children.length === 0
+            ? [box]
+            : [];
+    return [...own.filter(hasArea), ...box.children.flatMap(painted)];
+};
+const pastRoom = (room, { x, y, width, height }) => Math.max(room.x - x, room.y - y, x + width - (room.x + room.width), y + height - (room.y + room.height));
+/** How far `a` and `b` would have to move apart, along one axis, to clear each other. */
+const overlapOf = (a, b) => {
+    const width = Math.min(a.x + a.width, b.x + b.width) - Math.max(a.x, b.x);
+    const height = Math.min(a.y + a.height, b.y + b.height) - Math.max(a.y, b.y);
+    if (width <= tolerance || height <= tolerance) {
+        return 0;
+    }
+    return Math.min(a.x + a.width - b.x, b.x + b.width - a.x, a.y + a.height - b.y, b.y + b.height - a.y);
+};
+/**
+ * Where the nodes of `body` run past their room or onto each other in
+ * `layout`, a measured render on `surface` with node anchors on. Empty when
+ * nothing does.
+ *
+ * A node's room is the box of its nearest anchored or `layoutRoom` ancestor,
+ * or `layout` at the top level, and only siblings under one room are
+ * compared. Nothing inside a scaled box is checked. A finding is advice, not an error:
+ * an overlap may be intended.
+ */
+export const checkLayout = (layout, body, walk, surface) => {
+    const nodes = anchoredNodePaths(body, walk, surface);
+    const anchored = anchoredBoxes(layout);
+    const boxes = pairAnchors(anchored, nodes.map(({ node }) => node));
+    const placed = new Map();
+    boxes.forEach((box, index) => {
+        const { node, path } = nodes[index];
+        const type = nodeType(node);
+        if (box !== undefined && type !== undefined) {
+            placed.set(box, { box, path, type });
+        }
+    });
+    // Every anchored box bounds its ancestors' content, paired or not.
+    const nested = new Set(anchored.map(([, box]) => box));
+    const bounding = new Set([...nested, ...roomBoxes(layout)]);
+    const rooms = new Map();
+    const siblings = new Map();
+    const visit = (box, parent) => {
+        const node = placed.get(box);
+        if (node !== undefined) {
+            rooms.set(node, parent ?? layout);
+            siblings.set(parent, [...(siblings.get(parent) ?? []), node]);
+        }
+        if (!isScaled(box)) {
+            box.children.forEach((child) => visit(child, bounding.has(box) ? box : parent));
+        }
+    };
+    visit(layout, undefined);
+    const overflows = [...rooms].flatMap(([node, room]) => {
+        const by = Math.max(0, ...ownBoxes(node.box, nested)
+            .filter(hasArea)
+            .map((box) => pastRoom(room, box)));
+        return by > tolerance
+            ? [
+                {
+                    kind: 'overflow',
+                    path: node.path,
+                    type: node.type,
+                    by: Math.round(by),
+                },
+            ]
+            : [];
+    });
+    const overlaps = [...siblings.values()].flatMap((group) => {
+        const paints = group.map(({ box }) => painted(box));
+        return group.flatMap((first, i) => group.slice(i + 1).flatMap((second, offset) => {
+            const by = Math.max(0, ...paints[i].flatMap((a) => paints[i + 1 + offset].map((b) => overlapOf(a, b))));
+            return by > 0
+                ? [
+                    {
+                        kind: 'overlap',
+                        path: first.path,
+                        type: first.type,
+                        with: { path: second.path, type: second.type },
+                        by: Math.round(by),
+                    },
+                ]
+                : [];
+        }));
+    });
+    return [...overflows, ...overlaps];
+};
+//# sourceMappingURL=layout_check.js.map

package/dist/render/layout_check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout_check.js","sourceRoot":"","sources":["../../src/render/layout_check.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one\n * or more contributor license agreements. Licensed under the Elastic License\n * 2.0; you may not use this file except in compliance with the Elastic License\n * 2.0.\n */\n\nimport type { ChildNodeWalker } from '../composition/body_node_base';\n\nimport {\n  anchoredNodePaths,\n  LAYOUT_ROOM_ATTRIBUTE,\n  NODE_ANCHOR_ATTRIBUTE,\n  nodeType,\n  pairAnchors,\n} from './anchors';\n\n/** A rectangle on the canvas, in pixels. */\nexport interface LayoutRect {\n  readonly x: number;\n  readonly y: number;\n  readonly width: number;\n  readonly height: number;\n}\n\n/** A laid-out element and the elements nested in it, as a layout engine measures them. */\nexport interface LayoutBox extends LayoutRect {\n  /** Absent means unscaled. */\n  readonly scale?: number;\n  /** Text laid out in the box. */\n  readonly runs?: readonly LayoutRect[];\n  /** Where a {@link NODE_ANCHOR_ATTRIBUTE} is read from. */\n  readonly attributes?: Readonly<Record<string, string>>;\n  readonly children: readonly LayoutBox[];\n}\n\n/** A node drawn past the room its container gives it, or onto a sibling, by `by` pixels. */\nexport interface LayoutFinding {\n  kind: 'overflow' | 'overlap';\n  /** In validation's form, e.g. `body[1].items[0]`. */\n  path: string;\n  type: string;\n  /** The sibling an `overlap` lands on. */\n  with?: { path: string; type: string };\n  by: number;\n}\n\ninterface PlacedNode {\n  box: LayoutBox;\n  path: string;\n  type: string;\n}\n\n// Sub-pixel rounding reads as overflow without it.\nconst tolerance = 1;\n\nconst isScaled = ({ scale = 1 }: LayoutBox): boolean =>\n  Math.abs(scale - 1) > 0.001;\n\nconst hasArea = ({ width, height }: LayoutRect): boolean =>\n  width > 0 && height > 0;\n\n/** Every anchored box, pre-order, including those inside a scaled box, so a type's count matches its nodes. */\nconst anchoredBoxes = (box: LayoutBox): [string, LayoutBox][] => {\n  const value = box.attributes?.[NODE_ANCHOR_ATTRIBUTE];\n  return [\n    ...(value === undefined ? [] : [[value, box] as [string, LayoutBox]]),\n    ...box.children.flatMap(anchoredBoxes),\n  ];\n};\n\nconst roomBoxes = (box: LayoutBox): LayoutBox[] => [\n  ...(box.attributes?.[LAYOUT_ROOM_ATTRIBUTE] === undefined ? [] : [box]),\n  ...box.children.flatMap(roomBoxes),\n];\n\n/**\n * The element boxes a node's own content fills: its box and those under it,\n * down to the nodes nested in it. Text runs are left out because glyphs\n * overhang a tight line height; a scaled box counts as itself alone.\n */\nconst ownBoxes = (\n  box: LayoutBox,\n  nested: ReadonlySet<LayoutBox>\n): LayoutBox[] => [\n  box,\n  ...(isScaled(box)\n    ? []\n    : box.children.flatMap((child) =>\n        nested.has(child) ? [] : ownBoxes(child, nested)\n      )),\n];\n\n/** What a box paints: its text, or itself when it holds nothing else, like a dot or a rule. */\nconst painted = (box: LayoutBox): LayoutRect[] => {\n  if (isScaled(box)) {\n    return [box];\n  }\n  const own =\n    box.runs && box.runs.length > 0\n      ? box.runs\n      : box.children.length === 0\n        ? [box]\n        : [];\n  return [...own.filter(hasArea), ...box.children.flatMap(painted)];\n};\n\nconst pastRoom = (room: LayoutRect, { x, y, width, height }: LayoutRect) =>\n  Math.max(\n    room.x - x,\n    room.y - y,\n    x + width - (room.x + room.width),\n    y + height - (room.y + room.height)\n  );\n\n/** How far `a` and `b` would have to move apart, along one axis, to clear each other. */\nconst overlapOf = (a: LayoutRect, b: LayoutRect): number => {\n  const width = Math.min(a.x + a.width, b.x + b.width) - Math.max(a.x, b.x);\n  const height = Math.min(a.y + a.height, b.y + b.height) - Math.max(a.y, b.y);\n  if (width <= tolerance || height <= tolerance) {\n    return 0;\n  }\n  return Math.min(\n    a.x + a.width - b.x,\n    b.x + b.width - a.x,\n    a.y + a.height - b.y,\n    b.y + b.height - a.y\n  );\n};\n\n/**\n * Where the nodes of `body` run past their room or onto each other in\n * `layout`, a measured render on `surface` with node anchors on. Empty when\n * nothing does.\n *\n * A node's room is the box of its nearest anchored or `layoutRoom` ancestor,\n * or `layout` at the top level, and only siblings under one room are\n * compared. Nothing inside a scaled box is checked. A finding is advice, not an error:\n * an overlap may be intended.\n */\nexport const checkLayout = (\n  layout: LayoutBox,\n  body: readonly unknown[],\n  walk: ChildNodeWalker,\n  surface: 'react' | 'snapshot'\n): LayoutFinding[] => {\n  const nodes = anchoredNodePaths(body, walk, surface);\n  const anchored = anchoredBoxes(layout);\n  const boxes = pairAnchors(\n    anchored,\n    nodes.map(({ node }) => node)\n  );\n  const placed = new Map<LayoutBox, PlacedNode>();\n  boxes.forEach((box, index) => {\n    const { node, path } = nodes[index]!;\n    const type = nodeType(node);\n    if (box !== undefined && type !== undefined) {\n      placed.set(box, { box, path, type });\n    }\n  });\n\n  // Every anchored box bounds its ancestors' content, paired or not.\n  const nested = new Set(anchored.map(([, box]) => box));\n  const bounding = new Set([...nested, ...roomBoxes(layout)]);\n  const rooms = new Map<PlacedNode, LayoutBox>();\n  const siblings = new Map<LayoutBox | undefined, PlacedNode[]>();\n  const visit = (box: LayoutBox, parent: LayoutBox | undefined): void => {\n    const node = placed.get(box);\n    if (node !== undefined) {\n      rooms.set(node, parent ?? layout);\n      siblings.set(parent, [...(siblings.get(parent) ?? []), node]);\n    }\n    if (!isScaled(box)) {\n      box.children.forEach((child) =>\n        visit(child, bounding.has(box) ? box : parent)\n      );\n    }\n  };\n  visit(layout, undefined);\n\n  const overflows = [...rooms].flatMap(([node, room]): LayoutFinding[] => {\n    const by = Math.max(\n      0,\n      ...ownBoxes(node.box, nested)\n        .filter(hasArea)\n        .map((box) => pastRoom(room, box))\n    );\n    return by > tolerance\n      ? [\n          {\n            kind: 'overflow',\n            path: node.path,\n            type: node.type,\n            by: Math.round(by),\n          },\n        ]\n      : [];\n  });\n\n  const overlaps = [...siblings.values()].flatMap((group) => {\n    const paints = group.map(({ box }) => painted(box));\n    return group.flatMap((first, i) =>\n      group.slice(i + 1).flatMap((second, offset): LayoutFinding[] => {\n        const by = Math.max(\n          0,\n          ...paints[i]!.flatMap((a) =>\n            paints[i + 1 + offset]!.map((b) => overlapOf(a, b))\n          )\n        );\n        return by > 0\n          ? [\n              {\n                kind: 'overlap',\n                path: first.path,\n                type: first.type,\n                with: { path: second.path, type: second.type },\n                by: Math.round(by),\n              },\n            ]\n          : [];\n      })\n    );\n  });\n\n  return [...overflows, ...overlaps];\n};\n"]}

package/dist/render/markdown/builder.d.ts

@@ -0,0 +1,46 @@
+import { type MarkdownBlock, type MarkdownContent, type MarkdownInline, type MarkdownInlineInput } from '../../define/markdown_content.js';
+/** The node type of Markdown printed as written. */
+export declare const VERBATIM_TYPE = "isomerVerbatim";
+/**
+ * Builds Markdown as content rather than strings, so escaping follows where
+ * each value lands. Links and images apply the URL policy in
+ * `src/validate/url.ts`: a blocked link keeps its label on
+ * {@link BLOCKED_HREF}, and a blocked image degrades to its alt text.
+ *
+ * @example
+ * md.list(rows.map((row) => md.paragraph(md.strong(row.label), ': ', row.value)))
+ */
+export declare const md: {
+    text: (value: string) => MarkdownInline;
+    strong: (...children: MarkdownInlineInput[]) => MarkdownInline;
+    emphasis: (...children: MarkdownInlineInput[]) => MarkdownInline;
+    code: (value: string) => MarkdownInline;
+    link: (label: MarkdownInlineInput | readonly MarkdownInlineInput[], href: string) => MarkdownInline;
+    image: (alt: string, src: string) => MarkdownInline;
+    /** A hard line break, printed as a backslash before the line ending. Inside a heading, strong, emphasis, link label, or table cell it is a space; at the start or end of any of these, or of a paragraph, it is dropped. */
+    break: () => MarkdownInline;
+    paragraph: (...children: MarkdownInlineInput[]) => MarkdownBlock;
+    heading: (depth: 1 | 2 | 3 | 4 | 5 | 6, ...children: MarkdownInlineInput[]) => MarkdownBlock;
+    /** A quote with no blocks, such as one holding only a hidden child, is dropped. */
+    blockquote: (...children: MarkdownContent[]) => MarkdownContent;
+    /**
+     * An item that is inline input becomes one paragraph; one with no blocks,
+     * such as a hidden child, is dropped. A `start` that would print a marker
+     * GFM does not read as a list number is ignored.
+     */
+    list: (items: readonly (MarkdownInlineInput | MarkdownContent)[], { ordered, start }?: {
+        ordered?: boolean;
+        start?: number;
+    }) => MarkdownBlock;
+    /** A cell is one inline run or several. GFM trims a cell's edge whitespace. */
+    table: (columns: readonly (MarkdownInlineInput | readonly MarkdownInlineInput[])[], rows: readonly (readonly (MarkdownInlineInput | readonly MarkdownInlineInput[])[])[]) => MarkdownBlock;
+    /** An unsafe `language` is dropped. */
+    codeBlock: (value: string, language?: string) => MarkdownBlock;
+    /** Authored Markdown source, after {@link sanitizeAuthoredSource}; whitespace-only source is dropped. */
+    authored: (source: string) => MarkdownContent;
+};
+/** `content` as flat mdast blocks, typed `unknown` so no declaration names mdast. */
+export declare const markdownBlocks: (content: MarkdownContent) => readonly unknown[];
+/** `content` as GFM, without a trailing line break. */
+export declare const serializeMarkdown: (content: MarkdownContent) => string;
+//# sourceMappingURL=builder.d.ts.map

package/dist/render/markdown/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../../src/render/markdown/builder.ts"],"names":[],"mappings":"AA6BA,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,eAAe,EAEpB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACzB,MAAM,+BAA+B,CAAC;AAYvC,oDAAoD;AACpD,eAAO,MAAM,aAAa,mBAAmB,CAAC;AAyG9C;;;;;;;;GAQG;AACH,eAAO,MAAM,EAAE;kBACC,MAAM,KAAG,cAAc;0BACf,mBAAmB,EAAE,KAAG,cAAc;4BAEpC,mBAAmB,EAAE,KAAG,cAAc;kBAEhD,MAAM,KAAG,cAAc;kBAK5B,mBAAmB,GAAG,SAAS,mBAAmB,EAAE,QACrD,MAAM,KACX,cAAc;iBAMJ,MAAM,OAAO,MAAM,KAAG,cAAc;IAMjD,4NAA4N;iBACjN,cAAc;6BACA,mBAAmB,EAAE,KAAG,aAAa;qBAGrD,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,eACf,mBAAmB,EAAE,KACjC,aAAa;IAEhB,mFAAmF;8BACzD,eAAe,EAAE,KAAG,eAAe;IAS7D;;;;OAIG;kBAEM,SAAS,CAAC,mBAAmB,GAAG,eAAe,CAAC,EAAE,uBAC7B;QAAE,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,KAChE,aAAa;IAehB,+EAA+E;qBAEpE,SAAS,CAAC,mBAAmB,GAAG,SAAS,mBAAmB,EAAE,CAAC,EAAE,QACpE,SAAS,CAAC,SAAS,CACvB,mBAAmB,GAAG,SAAS,mBAAmB,EAAE,CACrD,EAAE,CAAC,EAAE,KACL,aAAa;IAWhB,uCAAuC;uBACpB,MAAM,aAAa,MAAM,KAAG,aAAa;IAS5D,yGAAyG;uBACtF,MAAM,KAAG,eAAe;CAO5C,CAAC;AA+CF,qFAAqF;AACrF,eAAO,MAAM,cAAc,GAAI,SAAS,eAAe,KAAG,SAAS,OAAO,EACpD,CAAC;AAEvB,uDAAuD;AACvD,eAAO,MAAM,iBAAiB,GAAI,SAAS,eAAe,KAAG,MAI1D,CAAC"}

package/dist/render/markdown/builder.js

@@ -0,0 +1,190 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+import { gfmToMarkdown } from 'mdast-util-gfm';
+import { defaultHandlers, toMarkdown, } from 'mdast-util-to-markdown';
+import { oneLine } from '../../composition/one_line.js';
+import { markdownContent, } from '../../define/markdown_content.js';
+import { BLOCKED_HREF, sanitizeAssetUrl, sanitizeNavigationHref, } from '../../validate/url.js';
+import { sanitizeAuthoredSource } from './format.js';
+// A fence-info string only allows word-ish tokens; anything else would
+// terminate the fence early or inject markdown.
+const FENCE_INFO_RE = /^[\w+#.-]+$/;
+/** The node type of Markdown printed as written. */
+export const VERBATIM_TYPE = 'isomerVerbatim';
+const inline = (node) => Object.assign(node, { [markdownContent]: 'inline' });
+const block = (node) => Object.assign(node, { [markdownContent]: 'block' });
+const isContentList = (content) => Array.isArray(content);
+const isInlineList = (label) => Array.isArray(label);
+const phrasing = (input) => typeof input === 'string'
+    ? { type: 'text', value: oneLine(input) }
+    : input;
+const emptyText = () => ({ type: 'text', value: '' });
+const isEmptyText = (node) => node.type === 'text' && node.value === '';
+// A break at either edge prints as a literal `\` or loose markers.
+const withoutEdgeBreaks = (inputs) => {
+    const children = inputs.map(phrasing).filter((node) => !isEmptyText(node));
+    let start = 0;
+    let end = children.length;
+    while (start < end && children[start].type === 'break') {
+        start += 1;
+    }
+    while (end > start && children[end - 1].type === 'break') {
+        end -= 1;
+    }
+    return children.slice(start, end);
+};
+// Only a paragraph breaks a line: a heading with one turns setext, and the
+// Slack fallback reads a line at a time.
+const inlineChildren = (inputs) => withoutEdgeBreaks(inputs).map((node) => node.type === 'break' ? { type: 'text', value: ' ' } : node);
+const rootContent = (content) => isContentList(content)
+    ? content.flatMap(rootContent)
+    : [content];
+const isInlineInput = (item) => typeof item === 'string' ||
+    (!isContentList(item) && item[markdownContent] === 'inline');
+const itemContent = (item) => isInlineInput(item)
+    ? [{ type: 'paragraph', children: withoutEdgeBreaks([item]) }]
+    : rootContent(item);
+// GFM reads a list number of at most nine digits, so the last item's must fit.
+const MAX_LIST_NUMBER = 999_999_999;
+const isListStart = (start, count) => start !== undefined &&
+    Number.isInteger(start) &&
+    start >= 0 &&
+    start + Math.max(count - 1, 0) <= MAX_LIST_NUMBER;
+// Printed as written, for Markdown that is already safe. Trailing whitespace
+// would add blank lines between blocks. `source` is the authored text when
+// sanitizing degraded it to inert text, whose escapes only Markdown resolves;
+// surfaces that print literal text read it instead.
+const verbatim = (markdown, source) => block({
+    type: VERBATIM_TYPE,
+    value: markdown.trimEnd(),
+    ...(source === undefined ? {} : { source }),
+});
+// An empty wrapper prints its markers alone: `****` reads as a thematic break.
+const wrapper = (type, inputs) => {
+    const children = inlineChildren(inputs);
+    return inline(children.length === 0 ? emptyText() : { type, children });
+};
+const inlineRuns = (runs) => inlineChildren(isInlineList(runs) ? runs : [runs]);
+/**
+ * Builds Markdown as content rather than strings, so escaping follows where
+ * each value lands. Links and images apply the URL policy in
+ * `src/validate/url.ts`: a blocked link keeps its label on
+ * {@link BLOCKED_HREF}, and a blocked image degrades to its alt text.
+ *
+ * @example
+ * md.list(rows.map((row) => md.paragraph(md.strong(row.label), ': ', row.value)))
+ */
+export const md = {
+    text: (value) => inline(phrasing(value)),
+    strong: (...children) => wrapper('strong', children),
+    emphasis: (...children) => wrapper('emphasis', children),
+    code: (value) => inline(value === '' ? emptyText() : { type: 'inlineCode', value: oneLine(value) }),
+    link: (label, href) => inline({
+        type: 'link',
+        url: sanitizeNavigationHref(href) ?? BLOCKED_HREF,
+        children: inlineRuns(label),
+    }),
+    image: (alt, src) => {
+        const url = sanitizeAssetUrl(src);
+        return url === null
+            ? inline(phrasing(alt))
+            : inline({ type: 'image', url, alt: oneLine(alt) });
+    },
+    /** A hard line break, printed as a backslash before the line ending. Inside a heading, strong, emphasis, link label, or table cell it is a space; at the start or end of any of these, or of a paragraph, it is dropped. */
+    break: () => inline({ type: 'break' }),
+    paragraph: (...children) => block({ type: 'paragraph', children: withoutEdgeBreaks(children) }),
+    heading: (depth, ...children) => block({ type: 'heading', depth, children: inlineChildren(children) }),
+    /** A quote with no blocks, such as one holding only a hidden child, is dropped. */
+    blockquote: (...children) => {
+        const content = rootContent(children);
+        return content.length === 0
+            ? []
+            : block({
+                type: 'blockquote',
+                children: content,
+            });
+    },
+    /**
+     * An item that is inline input becomes one paragraph; one with no blocks,
+     * such as a hidden child, is dropped. A `start` that would print a marker
+     * GFM does not read as a list number is ignored.
+     */
+    list: (items, { ordered = false, start } = {}) => {
+        const children = items.flatMap((item) => {
+            const content = itemContent(item);
+            return content.length === 0
+                ? []
+                : [{ type: 'listItem', spread: false, children: content }];
+        });
+        return block({
+            type: 'list',
+            ordered,
+            ...(isListStart(start, children.length) ? { start } : {}),
+            spread: false,
+            children,
+        });
+    },
+    /** A cell is one inline run or several. GFM trims a cell's edge whitespace. */
+    table: (columns, rows) => block({
+        type: 'table',
+        children: [columns, ...rows].map((cells) => ({
+            type: 'tableRow',
+            children: cells.map((cell) => ({
+                type: 'tableCell',
+                children: inlineRuns(cell),
+            })),
+        })),
+    }),
+    /** An unsafe `language` is dropped. */
+    codeBlock: (value, language) => block({
+        type: 'code',
+        lang: language !== undefined && FENCE_INFO_RE.test(language)
+            ? language
+            : null,
+        value,
+    }),
+    /** Authored Markdown source, after {@link sanitizeAuthoredSource}; whitespace-only source is dropped. */
+    authored: (source) => {
+        if (source.trim() === '') {
+            return [];
+        }
+        const { markdown, inert } = sanitizeAuthoredSource(source);
+        return verbatim(markdown, inert ? source : undefined);
+    },
+};
+const asText = (node, ...rest) => defaultHandlers.text({ type: 'text', value: node.value ?? node.alt ?? '' }, ...rest);
+// The URL policy again at serialization, for content built outside `md`.
+const handlers = {
+    link: (node, ...rest) => defaultHandlers.link({ ...node, url: sanitizeNavigationHref(node.url) ?? BLOCKED_HREF }, ...rest),
+    definition: (node, ...rest) => defaultHandlers.definition({ ...node, url: sanitizeNavigationHref(node.url) ?? BLOCKED_HREF }, ...rest),
+    image: (node, ...rest) => {
+        const url = sanitizeAssetUrl(node.url);
+        return url === null
+            ? asText(node, ...rest)
+            : defaultHandlers.image({ ...node, url }, ...rest);
+    },
+    html: asText,
+    [VERBATIM_TYPE]: (node) => node.value,
+};
+const OPTIONS = {
+    bullet: '-',
+    // With `*`, emphasis around strong prints `***x***`, which the Slack
+    // fallback cannot split. `_` costs character references around emphasis
+    // inside a word.
+    emphasis: '_',
+    fence: '`',
+    listItemIndent: 'one',
+    rule: '-',
+    strong: '*',
+    extensions: [gfmToMarkdown({ tablePipeAlign: false })],
+    handlers: handlers,
+};
+/** `content` as flat mdast blocks, typed `unknown` so no declaration names mdast. */
+export const markdownBlocks = (content) => rootContent(content);
+/** `content` as GFM, without a trailing line break. */
+export const serializeMarkdown = (content) => toMarkdown({ type: 'root', children: rootContent(content) }, OPTIONS).replace(/\n$/, '');
+//# sourceMappingURL=builder.js.map

package/dist/render/markdown/builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.js","sourceRoot":"","sources":["../../../src/render/markdown/builder.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one\n * or more contributor license agreements. Licensed under the Elastic License\n * 2.0; you may not use this file except in compliance with the Elastic License\n * 2.0.\n */\n\n// Builder content is mdast under a brand. Every mdast type stays inside this\n// module, so no emitted declaration names one.\n\nimport type {\n  Blockquote,\n  Definition,\n  Image,\n  Link,\n  ListItem,\n  PhrasingContent,\n  RootContent,\n  TableRow,\n} from 'mdast';\nimport { gfmToMarkdown } from 'mdast-util-gfm';\nimport {\n  defaultHandlers,\n  type Handle,\n  type Options,\n  toMarkdown,\n} from 'mdast-util-to-markdown';\n\nimport { oneLine } from '../../composition/one_line';\nimport {\n  type MarkdownBlock,\n  type MarkdownContent,\n  markdownContent,\n  type MarkdownInline,\n  type MarkdownInlineInput,\n} from '../../define/markdown_content';\nimport {\n  BLOCKED_HREF,\n  sanitizeAssetUrl,\n  sanitizeNavigationHref,\n} from '../../validate/url';\n\nimport { sanitizeAuthoredSource } from './format';\n\n// A fence-info string only allows word-ish tokens; anything else would\n// terminate the fence early or inject markdown.\nconst FENCE_INFO_RE = /^[\\w+#.-]+$/;\n/** The node type of Markdown printed as written. */\nexport const VERBATIM_TYPE = 'isomerVerbatim';\n\nconst inline = (node: PhrasingContent): MarkdownInline =>\n  Object.assign(node, { [markdownContent]: 'inline' as const });\n\nconst block = (node: RootContent): MarkdownBlock =>\n  Object.assign(node, { [markdownContent]: 'block' as const });\n\nconst isContentList = (\n  content: MarkdownInline | MarkdownContent\n): content is readonly MarkdownContent[] => Array.isArray(content);\n\nconst isInlineList = (\n  label: MarkdownInlineInput | readonly MarkdownInlineInput[]\n): label is readonly MarkdownInlineInput[] => Array.isArray(label);\n\nconst phrasing = (input: MarkdownInlineInput): PhrasingContent =>\n  typeof input === 'string'\n    ? { type: 'text', value: oneLine(input) }\n    : (input as unknown as PhrasingContent);\n\nconst emptyText = (): PhrasingContent => ({ type: 'text', value: '' });\n\nconst isEmptyText = (node: PhrasingContent): boolean =>\n  node.type === 'text' && node.value === '';\n\n// A break at either edge prints as a literal `\\` or loose markers.\nconst withoutEdgeBreaks = (\n  inputs: readonly MarkdownInlineInput[]\n): PhrasingContent[] => {\n  const children = inputs.map(phrasing).filter((node) => !isEmptyText(node));\n  let start = 0;\n  let end = children.length;\n  while (start < end && children[start]!.type === 'break') {\n    start += 1;\n  }\n  while (end > start && children[end - 1]!.type === 'break') {\n    end -= 1;\n  }\n  return children.slice(start, end);\n};\n\n// Only a paragraph breaks a line: a heading with one turns setext, and the\n// Slack fallback reads a line at a time.\nconst inlineChildren = (\n  inputs: readonly MarkdownInlineInput[]\n): PhrasingContent[] =>\n  withoutEdgeBreaks(inputs).map((node) =>\n    node.type === 'break' ? { type: 'text', value: ' ' } : node\n  );\n\nconst rootContent = (content: MarkdownContent): RootContent[] =>\n  isContentList(content)\n    ? content.flatMap(rootContent)\n    : [content as unknown as RootContent];\n\nconst isInlineInput = (\n  item: MarkdownInlineInput | MarkdownContent\n): item is MarkdownInlineInput =>\n  typeof item === 'string' ||\n  (!isContentList(item) && item[markdownContent] === 'inline');\n\nconst itemContent = (\n  item: MarkdownInlineInput | MarkdownContent\n): ListItem['children'] =>\n  isInlineInput(item)\n    ? [{ type: 'paragraph', children: withoutEdgeBreaks([item]) }]\n    : (rootContent(item) as ListItem['children']);\n\n// GFM reads a list number of at most nine digits, so the last item's must fit.\nconst MAX_LIST_NUMBER = 999_999_999;\n\nconst isListStart = (\n  start: number | undefined,\n  count: number\n): start is number =>\n  start !== undefined &&\n  Number.isInteger(start) &&\n  start >= 0 &&\n  start + Math.max(count - 1, 0) <= MAX_LIST_NUMBER;\n\n// Printed as written, for Markdown that is already safe. Trailing whitespace\n// would add blank lines between blocks. `source` is the authored text when\n// sanitizing degraded it to inert text, whose escapes only Markdown resolves;\n// surfaces that print literal text read it instead.\nconst verbatim = (markdown: string, source?: string): MarkdownBlock =>\n  block({\n    type: VERBATIM_TYPE,\n    value: markdown.trimEnd(),\n    ...(source === undefined ? {} : { source }),\n  } as unknown as RootContent);\n\n// An empty wrapper prints its markers alone: `****` reads as a thematic break.\nconst wrapper = (\n  type: 'strong' | 'emphasis',\n  inputs: MarkdownInlineInput[]\n): MarkdownInline => {\n  const children = inlineChildren(inputs);\n  return inline(children.length === 0 ? emptyText() : { type, children });\n};\n\nconst inlineRuns = (\n  runs: MarkdownInlineInput | readonly MarkdownInlineInput[]\n): PhrasingContent[] => inlineChildren(isInlineList(runs) ? runs : [runs]);\n\n/**\n * Builds Markdown as content rather than strings, so escaping follows where\n * each value lands. Links and images apply the URL policy in\n * `src/validate/url.ts`: a blocked link keeps its label on\n * {@link BLOCKED_HREF}, and a blocked image degrades to its alt text.\n *\n * @example\n * md.list(rows.map((row) => md.paragraph(md.strong(row.label), ': ', row.value)))\n */\nexport const md = {\n  text: (value: string): MarkdownInline => inline(phrasing(value)),\n  strong: (...children: MarkdownInlineInput[]): MarkdownInline =>\n    wrapper('strong', children),\n  emphasis: (...children: MarkdownInlineInput[]): MarkdownInline =>\n    wrapper('emphasis', children),\n  code: (value: string): MarkdownInline =>\n    inline(\n      value === '' ? emptyText() : { type: 'inlineCode', value: oneLine(value) }\n    ),\n  link: (\n    label: MarkdownInlineInput | readonly MarkdownInlineInput[],\n    href: string\n  ): MarkdownInline =>\n    inline({\n      type: 'link',\n      url: sanitizeNavigationHref(href) ?? BLOCKED_HREF,\n      children: inlineRuns(label),\n    }),\n  image: (alt: string, src: string): MarkdownInline => {\n    const url = sanitizeAssetUrl(src);\n    return url === null\n      ? inline(phrasing(alt))\n      : inline({ type: 'image', url, alt: oneLine(alt) });\n  },\n  /** A hard line break, printed as a backslash before the line ending. Inside a heading, strong, emphasis, link label, or table cell it is a space; at the start or end of any of these, or of a paragraph, it is dropped. */\n  break: (): MarkdownInline => inline({ type: 'break' }),\n  paragraph: (...children: MarkdownInlineInput[]): MarkdownBlock =>\n    block({ type: 'paragraph', children: withoutEdgeBreaks(children) }),\n  heading: (\n    depth: 1 | 2 | 3 | 4 | 5 | 6,\n    ...children: MarkdownInlineInput[]\n  ): MarkdownBlock =>\n    block({ type: 'heading', depth, children: inlineChildren(children) }),\n  /** A quote with no blocks, such as one holding only a hidden child, is dropped. */\n  blockquote: (...children: MarkdownContent[]): MarkdownContent => {\n    const content = rootContent(children);\n    return content.length === 0\n      ? []\n      : block({\n          type: 'blockquote',\n          children: content as Blockquote['children'],\n        });\n  },\n  /**\n   * An item that is inline input becomes one paragraph; one with no blocks,\n   * such as a hidden child, is dropped. A `start` that would print a marker\n   * GFM does not read as a list number is ignored.\n   */\n  list: (\n    items: readonly (MarkdownInlineInput | MarkdownContent)[],\n    { ordered = false, start }: { ordered?: boolean; start?: number } = {}\n  ): MarkdownBlock => {\n    const children = items.flatMap((item): ListItem[] => {\n      const content = itemContent(item);\n      return content.length === 0\n        ? []\n        : [{ type: 'listItem', spread: false, children: content }];\n    });\n    return block({\n      type: 'list',\n      ordered,\n      ...(isListStart(start, children.length) ? { start } : {}),\n      spread: false,\n      children,\n    });\n  },\n  /** A cell is one inline run or several. GFM trims a cell's edge whitespace. */\n  table: (\n    columns: readonly (MarkdownInlineInput | readonly MarkdownInlineInput[])[],\n    rows: readonly (readonly (\n      MarkdownInlineInput | readonly MarkdownInlineInput[]\n    )[])[]\n  ): MarkdownBlock =>\n    block({\n      type: 'table',\n      children: [columns, ...rows].map((cells): TableRow => ({\n        type: 'tableRow',\n        children: cells.map((cell) => ({\n          type: 'tableCell',\n          children: inlineRuns(cell),\n        })),\n      })),\n    }),\n  /** An unsafe `language` is dropped. */\n  codeBlock: (value: string, language?: string): MarkdownBlock =>\n    block({\n      type: 'code',\n      lang:\n        language !== undefined && FENCE_INFO_RE.test(language)\n          ? language\n          : null,\n      value,\n    }),\n  /** Authored Markdown source, after {@link sanitizeAuthoredSource}; whitespace-only source is dropped. */\n  authored: (source: string): MarkdownContent => {\n    if (source.trim() === '') {\n      return [];\n    }\n    const { markdown, inert } = sanitizeAuthoredSource(source);\n    return verbatim(markdown, inert ? source : undefined);\n  },\n};\n\nconst asText: Handle = (\n  node: { value?: string; alt?: string | null },\n  ...rest\n) =>\n  defaultHandlers.text(\n    { type: 'text', value: node.value ?? node.alt ?? '' },\n    ...rest\n  );\n\n// The URL policy again at serialization, for content built outside `md`.\nconst handlers: Record<string, Handle> = {\n  link: (node: Link, ...rest) =>\n    defaultHandlers.link(\n      { ...node, url: sanitizeNavigationHref(node.url) ?? BLOCKED_HREF },\n      ...rest\n    ),\n  definition: (node: Definition, ...rest) =>\n    defaultHandlers.definition(\n      { ...node, url: sanitizeNavigationHref(node.url) ?? BLOCKED_HREF },\n      ...rest\n    ),\n  image: (node: Image, ...rest) => {\n    const url = sanitizeAssetUrl(node.url);\n    return url === null\n      ? asText(node, ...rest)\n      : defaultHandlers.image({ ...node, url }, ...rest);\n  },\n  html: asText,\n  [VERBATIM_TYPE]: (node: { value: string }) => node.value,\n};\n\nconst OPTIONS: Options = {\n  bullet: '-',\n  // With `*`, emphasis around strong prints `***x***`, which the Slack\n  // fallback cannot split. `_` costs character references around emphasis\n  // inside a word.\n  emphasis: '_',\n  fence: '`',\n  listItemIndent: 'one',\n  rule: '-',\n  strong: '*',\n  extensions: [gfmToMarkdown({ tablePipeAlign: false })],\n  handlers: handlers as Options['handlers'],\n};\n\n/** `content` as flat mdast blocks, typed `unknown` so no declaration names mdast. */\nexport const markdownBlocks = (content: MarkdownContent): readonly unknown[] =>\n  rootContent(content);\n\n/** `content` as GFM, without a trailing line break. */\nexport const serializeMarkdown = (content: MarkdownContent): string =>\n  toMarkdown({ type: 'root', children: rootContent(content) }, OPTIONS).replace(\n    /\\n$/,\n    ''\n  );\n"]}

package/dist/render/markdown/envelope.d.ts

@@ -0,0 +1,20 @@
+import type { Composition } from '../../composition/composition.js';
+import type { PrimitiveNode } from '../../define/primitive_module.js';
+import type { TextEnvelopeDispatcher } from '../text/envelope.js';
+/** Adds GFM to {@link TextEnvelopeDispatcher}. */
+export interface MarkdownEnvelopeDispatcher<TNode extends PrimitiveNode> extends TextEnvelopeDispatcher<TNode> {
+    /** Returns the empty string for a node with nothing to show; the envelope drops it rather than emitting a blank block. */
+    renderMarkdown(node: TNode): string;
+}
+/** Options for {@link renderMarkdownEnvelope}. */
+export interface MarkdownEnvelopeOptions {
+    /** Renders the composition's title and subtitle. Defaults to `true`. Pass `false` when the host already shows the title, or the body opens with its own. */
+    heading?: boolean;
+}
+/**
+ * The composition as GFM: title as `h1`, subtitle italicized, then every node
+ * that rendered anything. The title and subtitle are text, escaped by
+ * {@link serializeMarkdown}.
+ */
+export declare const renderMarkdownEnvelope: <TNode extends PrimitiveNode>(composition: Composition<TNode>, dispatcher: MarkdownEnvelopeDispatcher<TNode>, { heading }?: MarkdownEnvelopeOptions) => string;
+//# sourceMappingURL=envelope.d.ts.map

package/dist/render/markdown/envelope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.d.ts","sourceRoot":"","sources":["../../../src/render/markdown/envelope.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAI/D,kDAAkD;AAClD,MAAM,WAAW,0BAA0B,CACzC,KAAK,SAAS,aAAa,CAC3B,SAAQ,sBAAsB,CAAC,KAAK,CAAC;IACrC,0HAA0H;IAC1H,cAAc,CAAC,IAAI,EAAE,KAAK,GAAG,MAAM,CAAC;CACrC;AAED,kDAAkD;AAClD,MAAM,WAAW,uBAAuB;IACtC,4JAA4J;IAC5J,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,GAAI,KAAK,SAAS,aAAa,EAChE,aAAa,WAAW,CAAC,KAAK,CAAC,EAC/B,YAAY,0BAA0B,CAAC,KAAK,CAAC,EAC7C,cAAoB,uBAA4B,KAC/C,MAiBF,CAAC"}

package/dist/render/markdown/envelope.js

@@ -0,0 +1,29 @@
+/*
+ * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one
+ * or more contributor license agreements. Licensed under the Elastic License
+ * 2.0; you may not use this file except in compliance with the Elastic License
+ * 2.0.
+ */
+import { md, serializeMarkdown } from './builder.js';
+/**
+ * The composition as GFM: title as `h1`, subtitle italicized, then every node
+ * that rendered anything. The title and subtitle are text, escaped by
+ * {@link serializeMarkdown}.
+ */
+export const renderMarkdownEnvelope = (composition, dispatcher, { heading = true } = {}) => {
+    const blocks = [];
+    if (heading && composition.title) {
+        blocks.push(serializeMarkdown(md.heading(1, composition.title)));
+    }
+    if (heading && composition.subtitle) {
+        blocks.push(serializeMarkdown(md.paragraph(md.emphasis(composition.subtitle))));
+    }
+    for (const node of composition.body) {
+        const rendered = dispatcher.renderMarkdown(node);
+        if (rendered.length > 0) {
+            blocks.push(rendered);
+        }
+    }
+    return blocks.join('\n\n');
+};
+//# sourceMappingURL=envelope.js.map

package/dist/render/markdown/envelope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelope.js","sourceRoot":"","sources":["../../../src/render/markdown/envelope.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,EAAE,EAAE,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAgBlD;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CACpC,WAA+B,EAC/B,UAA6C,EAC7C,EAAE,OAAO,GAAG,IAAI,KAA8B,EAAE,EACxC,EAAE;IACV,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,OAAO,IAAI,WAAW,CAAC,KAAK,EAAE,CAAC;QACjC,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnE,CAAC;IACD,IAAI,OAAO,IAAI,WAAW,CAAC,QAAQ,EAAE,CAAC;QACpC,MAAM,CAAC,IAAI,CACT,iBAAiB,CAAC,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,CACnE,CAAC;IACJ,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,IAAI,EAAE,CAAC;QACpC,MAAM,QAAQ,GAAG,UAAU,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QACjD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC7B,CAAC,CAAC","sourcesContent":["/*\n * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one\n * or more contributor license agreements. Licensed under the Elastic License\n * 2.0; you may not use this file except in compliance with the Elastic License\n * 2.0.\n */\n\nimport type { Composition } from '../../composition/composition';\nimport type { PrimitiveNode } from '../../define/primitive_module';\nimport type { TextEnvelopeDispatcher } from '../text/envelope';\n\nimport { md, serializeMarkdown } from './builder';\n\n/** Adds GFM to {@link TextEnvelopeDispatcher}. */\nexport interface MarkdownEnvelopeDispatcher<\n  TNode extends PrimitiveNode,\n> extends TextEnvelopeDispatcher<TNode> {\n  /** Returns the empty string for a node with nothing to show; the envelope drops it rather than emitting a blank block. */\n  renderMarkdown(node: TNode): string;\n}\n\n/** Options for {@link renderMarkdownEnvelope}. */\nexport interface MarkdownEnvelopeOptions {\n  /** Renders the composition's title and subtitle. Defaults to `true`. Pass `false` when the host already shows the title, or the body opens with its own. */\n  heading?: boolean;\n}\n\n/**\n * The composition as GFM: title as `h1`, subtitle italicized, then every node\n * that rendered anything. The title and subtitle are text, escaped by\n * {@link serializeMarkdown}.\n */\nexport const renderMarkdownEnvelope = <TNode extends PrimitiveNode>(\n  composition: Composition<TNode>,\n  dispatcher: MarkdownEnvelopeDispatcher<TNode>,\n  { heading = true }: MarkdownEnvelopeOptions = {}\n): string => {\n  const blocks: string[] = [];\n  if (heading && composition.title) {\n    blocks.push(serializeMarkdown(md.heading(1, composition.title)));\n  }\n  if (heading && composition.subtitle) {\n    blocks.push(\n      serializeMarkdown(md.paragraph(md.emphasis(composition.subtitle)))\n    );\n  }\n  for (const node of composition.body) {\n    const rendered = dispatcher.renderMarkdown(node);\n    if (rendered.length > 0) {\n      blocks.push(rendered);\n    }\n  }\n  return blocks.join('\\n\\n');\n};\n"]}

package/dist/render/markdown/format.d.ts

@@ -0,0 +1,10 @@
+/** `markdown` as flat GFM mdast blocks, typed `unknown` so no declaration names mdast; `null` past the parse budget or the parser's recursion depth. */
+export declare const parseGfmBlocks: (markdown: string) => readonly unknown[] | null;
+/** {@link sanitizeMarkdownSource}'s result, and whether it degraded to inert text. */
+export declare const sanitizeAuthoredSource: (markdown: string) => {
+    markdown: string;
+    inert: boolean;
+};
+/** Sanitizes GFM destinations and HTML; excessive syntax or length degrades to inert text. */
+export declare const sanitizeMarkdownSource: (markdown: string) => string;
+//# sourceMappingURL=format.d.ts.map

package/dist/render/markdown/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../src/render/markdown/format.ts"],"names":[],"mappings":"AAkDA,wJAAwJ;AACxJ,eAAO,MAAM,cAAc,GAAI,UAAU,MAAM,KAAG,SAAS,OAAO,EAAE,GAAG,IAQtE,CAAC;AA6HF,sFAAsF;AACtF,eAAO,MAAM,sBAAsB,GACjC,UAAU,MAAM,KACf;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAiBpC,CAAC;AAEF,8FAA8F;AAC9F,eAAO,MAAM,sBAAsB,GAAI,UAAU,MAAM,KAAG,MACf,CAAC"}