@bendyline/squisq 2.11.16 → 2.11.18

package/dist/index.js

@@ -27,7 +27,7 @@ import {
   recordSlideShown,
   traceWordPosAt,
   vadStep
-} from "./chunk-IRVXZUVU.js";
+} from "./chunk-RYO4QW6R.js";
 import {
   fenceRendererLangs
 } from "./chunk-PGI7HSWE.js";
@@ -54,23 +54,6 @@ import {
   selectSafeZoneClips,
   selectTranscriptClips
 } from "./chunk-ZP5F7LUH.js";
-import {
-  DEFAULT_TRANSFORM_STYLE_ID,
-  allocateTiming,
-  analyzeBlocks,
-  applyTransform,
-  createTransformStyleRegistry,
-  extractDocImages,
-  getTransformStyleIds,
-  getTransformStyleSummaries,
-  resolveTransformStyle,
-  transformNarratedSegment
-} from "./chunk-IFJPPI63.js";
-import {
-  extractContent,
-  mapElementToBlock,
-  stripMarkdown
-} from "./chunk-SVN7T6BK.js";
 import {
   DATA_BACKUP_PREFIX,
   DocumentVersionManager,
@@ -154,7 +137,7 @@ import {
   pipStyleVars,
   serializeTheme,
   validateDocSchema
-} from "./chunk-HVJ6VFDX.js";
+} from "./chunk-GB7OFYUK.js";
 import {
   calculateBearing,
   decodeGeohash,
@@ -246,18 +229,39 @@ import {
   validateMarkdownSource,
   wordRevealDelay,
   writeDashboardLayoutsToFrontmatter
-} from "./chunk-NC6LD6D3.js";
+} from "./chunk-J4ACZBO4.js";
 import {
-  buildNarrationScript,
   buildNarrationTimingJson,
-  estimateSyllables,
-  expectedSyllablesAt,
   parseNarrationTimingJson,
-  resolveNarrationTimingGenerator,
-  wordIndexAtChar,
-  wordIndexAtTime,
-  wordPosAtExpectedSyllables
-} from "./chunk-5W7F46OO.js";
+  resolveNarrationTimingGenerator
+} from "./chunk-3XEABCT3.js";
+import {
+  DEFAULT_TRANSFORM_STYLE_ID,
+  DYNAMIC_PRESENTATION_STYLE,
+  PRESENTATION_HINTS_KEY,
+  PRESENTATION_KEY,
+  PRESENTATION_LAYOUTS,
+  PRESENTATION_LIMITS,
+  allocateTiming,
+  analyzeBlocks,
+  applySavedPresentation,
+  applyTransform,
+  compilePresentationPlan,
+  createPresentationPlan,
+  createTransformStyleRegistry,
+  defaultPresentationHints,
+  extractDocImages,
+  getTransformStyleIds,
+  getTransformStyleSummaries,
+  parsePresentationHints,
+  parsePresentationPlan,
+  presentationSections,
+  resolveTransformStyle,
+  serializePresentationHints,
+  serializePresentationPlan,
+  transformNarratedSegment,
+  usesDynamicPresentation
+} from "./chunk-NM747LUO.js";
 import {
   ASCII_CHAR_H,
   ASCII_CHAR_W,
@@ -283,6 +287,7 @@ import {
   asciiTimelineToTemplateData,
   autoTemplatePreservesContent,
   bigText,
+  buildNarrationScript,
   buildRegistry,
   canvasToAsciiCell,
   coerceTemplateParams,
@@ -301,14 +306,17 @@ import {
   deriveTemplateInputs,
   diagramBlock,
   drawingBlock,
+  estimateSyllables,
   expandCoverBlock,
   expandDocBlocks,
   expandPersistentLayers,
+  expectedSyllablesAt,
   extractBlockquoteText,
   extractBodyPlainText,
   extractEmbeddedVideos,
   extractFirstEmbeddedVideo,
   extractFirstImage,
+  extractHostedVideos,
   extractImages,
   extractListItems,
   extractRichListItems,
@@ -341,6 +349,7 @@ import {
   imageWithCaption,
   isDataFence,
   isGeometryBoundTemplate,
+  isMaterializedMediaNode,
   isShapeName,
   layoutBlock,
   leftFeature,
@@ -386,10 +395,13 @@ import {
   twoColumn,
   videoPullQuote,
   videoWithCaption,
+  wordIndexAtChar,
+  wordIndexAtTime,
+  wordPosAtExpectedSyllables,
   wrapWithPersistentLayers,
   writeCustomTemplatesToFrontmatter,
   writeCustomThemesToFrontmatter
-} from "./chunk-WMXQDP2C.js";
+} from "./chunk-7IGKCHDP.js";
 import {
   ASCII_DIAGRAM_FENCE_LANGS,
   ASCII_TIMELINE_FENCE_LANGS,
@@ -414,7 +426,12 @@ import {
   parseWrappedFlowTimeline,
   profileBlockContents,
   recommendTemplatesForBlock
-} from "./chunk-C3NAY5YP.js";
+} from "./chunk-A5QJJZ5S.js";
+import {
+  extractContent,
+  mapElementToBlock,
+  stripMarkdown
+} from "./chunk-SVN7T6BK.js";
 import {
   PATH_SHAPE_KINDS,
   anchorPoint,
@@ -550,7 +567,7 @@ import {
   stringifyMarkdown,
   unwrapMarkdownSource,
   wrapMarkdownSource
-} from "./chunk-ANH2OZ2M.js";
+} from "./chunk-LJZHC6GN.js";
 import {
   DEFAULT_MARKDOWN_SAFETY_LIMITS,
   MarkdownLimitError,
@@ -562,7 +579,7 @@ import {
   resolveMarkdownSafetyLimits,
   serializePandocAttributes,
   toMdast
-} from "./chunk-GDHXT5Q7.js";
+} from "./chunk-PGWYC3S2.js";
 import {
   BLOCK_META_KEY_DESCRIPTORS,
   CONTAINER_TEMPLATES,
@@ -580,26 +597,36 @@ import {
   splitKeyValueToken,
   tokenizeAttrTokens,
   unquoteAttrValue
-} from "./chunk-TMOHAFYE.js";
+} from "./chunk-WSFXV5BT.js";
 import {
+  VIDEO_EMBED_IFRAME_ALLOW,
+  VIDEO_EMBED_PROVIDERS,
   countNodes,
   createDocument,
   extractPlainText,
+  findBlockVideoEmbed,
   findNodesByType,
   formatBlockScalar,
   formatFrontmatterValue,
   formatFrontmatterYaml,
   getChildren,
   inferDocumentTitle,
+  isVideoEmbedUrl,
+  mediaKindForUrl,
   parseFrontmatter,
   parseHtmlToNodes,
+  parseVideoEmbedInput,
+  parseVideoEmbedUrl,
+  parseVideoStartTime,
   plainTextFromInlineHtml,
   readFrontmatterThemeId,
   setFrontmatterValues,
   splitFrontmatterBlock,
   stringifyHtmlNodes,
+  videoEmbedFromIframe,
+  videoEmbedIframeAttributes,
   walkMarkdownTree
-} from "./chunk-X7BNDUNI.js";
+} from "./chunk-Q6ELOAOQ.js";
 import {
   ICONS,
   canonicalIconToken,
@@ -683,6 +710,7 @@ export {
   DIAGRAM_LABEL_LINE_HEIGHT,
   DIAGRAM_LABEL_MIN_FONT_SIZE,
   DIAGRAM_LABEL_VERTICAL_PADDING,
+  DYNAMIC_PRESENTATION_STYLE,
   DocumentVersionManager,
   EMPTY_ADVANCE_LOG,
   FONT_FALLBACKS,
@@ -730,6 +758,10 @@ export {
   PAGE_SHADOWS,
   PAGE_VARIANTS,
   PATH_SHAPE_KINDS,
+  PRESENTATION_HINTS_KEY,
+  PRESENTATION_KEY,
+  PRESENTATION_LAYOUTS,
+  PRESENTATION_LIMITS,
   PROOF_DIALECTS,
   PROOF_FRONTMATTER_KEYS,
   PROOF_JOIN_SEPARATOR,
@@ -749,6 +781,8 @@ export {
   TREE_FENCE_LANGS,
   VERSIONS_PREFIX,
   VERSION_TIMESTAMP_PATTERN,
+  VIDEO_EMBED_IFRAME_ALLOW,
+  VIDEO_EMBED_PROVIDERS,
   VIEWPORT_PRESETS,
   accentForViewport,
   accentToColorScheme,
@@ -763,6 +797,7 @@ export {
   applyMarkdownSourceTransform,
   applyNarrationTiming,
   applyRenderStyleToLayers,
+  applySavedPresentation,
   applySurface,
   applyTransform,
   arrayItemKind,
@@ -813,6 +848,7 @@ export {
   coalesceVersions,
   coerceTemplateParams,
   comparisonBar,
+  compilePresentationPlan,
   compileTheme,
   composeDashboardLayers,
   computeDiagramLayout,
@@ -836,6 +872,7 @@ export {
   createNarrationSession,
   createNucleiState,
   createPacingState,
+  createPresentationPlan,
   createTemplateContext,
   createTheme,
   createThemeRegistry,
@@ -849,6 +886,7 @@ export {
   dateEvent,
   decodeGeohash,
   defaultPageStyle,
+  defaultPresentationHints,
   definitionCard,
   deriveColorPalette,
   deriveScale,
@@ -888,6 +926,7 @@ export {
   extractFirstEmbeddedVideo,
   extractFirstImage,
   extractFrameFeatures,
+  extractHostedVideos,
   extractImages,
   extractKeywords,
   extractListItems,
@@ -900,6 +939,7 @@ export {
   featureStep,
   fenceRendererLangs,
   fetchResourceBytes,
+  findBlockVideoEmbed,
   findDocumentPath,
   findFirstList,
   findFirstTable,
@@ -987,6 +1027,7 @@ export {
   isExplicitTreeLang,
   isGeometryBoundTemplate,
   isHex,
+  isMaterializedMediaNode,
   isMotionProfileName,
   isPersistentLayerTemplate,
   isRepairableDiagram,
@@ -997,6 +1038,7 @@ export {
   isTemplatedPageBlock,
   isTransitionType,
   isTreeFence,
+  isVideoEmbedUrl,
   isWrappedFlowTimelineSource,
   layoutBlock,
   layoutCapacity,
@@ -1025,6 +1067,7 @@ export {
   materializePageSection,
   materializePageSections,
   mayBeAnimatedImage,
+  mediaKindForUrl,
   motionDelay,
   motionEntrance,
   motionStateTransform,
@@ -1052,6 +1095,8 @@ export {
   parseMarkdown,
   parseNarrationTimingJson,
   parsePandocAttrTokens,
+  parsePresentationHints,
+  parsePresentationPlan,
   parseProofDictionary,
   parseStatNumber,
   parseTheme,
@@ -1059,6 +1104,9 @@ export {
   parseTree,
   parseVersionPath,
   parseVersionTimestamp,
+  parseVideoEmbedInput,
+  parseVideoEmbedUrl,
+  parseVideoStartTime,
   parseWrappedFlowTimeline,
   parseYamlSubset,
   photoGrid,
@@ -1066,6 +1114,7 @@ export {
   pipStyleVars,
   plainTextFromInlineHtml,
   pointerSegments,
+  presentationSections,
   primaryType,
   profileBlockContents,
   pruneImageEditVersions,
@@ -1145,6 +1194,8 @@ export {
   selectSafeZoneClips,
   selectTranscriptClips,
   serializePandocAttributes,
+  serializePresentationHints,
+  serializePresentationPlan,
   serializeTheme,
   setByPointer,
   setCanvas,
@@ -1189,6 +1240,7 @@ export {
   unquoteAttrValue,
   unwrapMarkdownSource,
   updateLayer,
+  usesDynamicPresentation,
   vadStep,
   validateCustomTemplateDefinition,
   validateDashboardLayoutDefinition,
@@ -1196,6 +1248,8 @@ export {
   validateMarkdownDoc,
   validateMarkdownSource,
   validateTheme,
+  videoEmbedFromIframe,
+  videoEmbedIframeAttributes,
   videoPullQuote,
   videoWithCaption,
   walkMarkdownTree,

package/dist/jsonForm/index.d.ts

@@ -1,4 +1,4 @@
-import { bw as Theme, bm as SurfaceScheme } from '../Doc-Bd2kdzuy.js';
+import { bw as Theme, bm as SurfaceScheme } from '../Doc-B6TYHYGc.js';
 import '../types-C6VvDDL2.js';
 
 /**

package/dist/jsonForm/index.js

@@ -16,7 +16,7 @@ import {
   setByPointer,
   toPointer
 } from "../chunk-7WN7DDMI.js";
-import "../chunk-HVJ6VFDX.js";
+import "../chunk-GB7OFYUK.js";
 import "../chunk-2SRF5III.js";
 import "../chunk-PFH3WV6J.js";
 import "../chunk-JSGIWW35.js";

package/dist/markdown/index.d.ts

@@ -1,5 +1,5 @@
-import { $ as ParseOptions, n as MarkdownDocument, a0 as StringifyOptions, H as HeadingAttributes, e as HtmlNode, L as MarkdownNode } from '../types-C6VvDDL2.js';
-export { D as DEFAULT_MARKDOWN_SAFETY_LIMITS, b as HeadingTemplateAnnotation, c as HtmlComment, d as HtmlElement, f as HtmlText, M as MarkdownBlockNode, g as MarkdownBlockquote, h as MarkdownBreak, i as MarkdownCodeBlock, j as MarkdownContainerDirective, k as MarkdownDefinitionDescription, l as MarkdownDefinitionList, m as MarkdownDefinitionTerm, o as MarkdownEmphasis, p as MarkdownFootnoteDefinition, q as MarkdownFootnoteReference, r as MarkdownHeading, s as MarkdownHtmlBlock, t as MarkdownImage, u as MarkdownImageReference, v as MarkdownInlineCode, w as MarkdownInlineHtml, x as MarkdownInlineIcon, y as MarkdownInlineMath, z as MarkdownInlineNode, A as MarkdownLeafDirective, B as MarkdownLimitError, C as MarkdownLink, E as MarkdownLinkDefinition, F as MarkdownLinkReference, G as MarkdownList, I as MarkdownListItem, J as MarkdownMathBlock, K as MarkdownMention, N as MarkdownParagraph, O as MarkdownPoint, P as MarkdownSafetyLimits, Q as MarkdownSourcePosition, R as MarkdownStrikethrough, S as MarkdownStrong, T as MarkdownSubscript, U as MarkdownSuperscript, V as MarkdownTable, W as MarkdownTableCell, X as MarkdownTableRow, Y as MarkdownText, Z as MarkdownTextDirective, _ as MarkdownThematicBreak, a6 as assertMarkdownDocumentWithinLimits, a7 as assertMarkdownSourceWithinLimits, ac as resolveMarkdownSafetyLimits } from '../types-C6VvDDL2.js';
+import { $ as ParseOptions, n as MarkdownDocument, a0 as StringifyOptions, H as HeadingAttributes, e as HtmlNode, M as MarkdownBlockNode, d as HtmlElement, L as MarkdownNode } from '../types-C6VvDDL2.js';
+export { D as DEFAULT_MARKDOWN_SAFETY_LIMITS, b as HeadingTemplateAnnotation, c as HtmlComment, f as HtmlText, g as MarkdownBlockquote, h as MarkdownBreak, i as MarkdownCodeBlock, j as MarkdownContainerDirective, k as MarkdownDefinitionDescription, l as MarkdownDefinitionList, m as MarkdownDefinitionTerm, o as MarkdownEmphasis, p as MarkdownFootnoteDefinition, q as MarkdownFootnoteReference, r as MarkdownHeading, s as MarkdownHtmlBlock, t as MarkdownImage, u as MarkdownImageReference, v as MarkdownInlineCode, w as MarkdownInlineHtml, x as MarkdownInlineIcon, y as MarkdownInlineMath, z as MarkdownInlineNode, A as MarkdownLeafDirective, B as MarkdownLimitError, C as MarkdownLink, E as MarkdownLinkDefinition, F as MarkdownLinkReference, G as MarkdownList, I as MarkdownListItem, J as MarkdownMathBlock, K as MarkdownMention, N as MarkdownParagraph, O as MarkdownPoint, P as MarkdownSafetyLimits, Q as MarkdownSourcePosition, R as MarkdownStrikethrough, S as MarkdownStrong, T as MarkdownSubscript, U as MarkdownSuperscript, V as MarkdownTable, W as MarkdownTableCell, X as MarkdownTableRow, Y as MarkdownText, Z as MarkdownTextDirective, _ as MarkdownThematicBreak, a6 as assertMarkdownDocumentWithinLimits, a7 as assertMarkdownSourceWithinLimits, ac as resolveMarkdownSafetyLimits } from '../types-C6VvDDL2.js';
 export { B as BLOCK_META_KEY_DESCRIPTORS, a as BlockMetaKeyDescriptor, K as KNOWN_BLOCK_META_KEYS, b as KnownBlockMetaKey, p as parseTimeSeconds } from '../annotationCoercion-BgL52343.js';
 
 /**
@@ -296,6 +296,147 @@ declare function sanitizeUrl(url: string | null | undefined, kind?: UrlKind, opt
  */
 declare function sanitizeHtmlNodes(nodes: HtmlNode[]): HtmlNode[];
 
+/**
+ * Hosted-video embeds (YouTube, Vimeo, Loom, Dailymotion, Wistia).
+ *
+ * The authored form is a paragraph that is ONLY a link, or a bare URL, to a
+ * video page:
+ *
+ * ```markdown
+ * [Launch keynote](https://www.youtube.com/watch?v=dQw4w9WgXcQ)
+ *
+ * https://vimeo.com/76979871
+ * ```
+ *
+ * GitHub, Notion and Medium all follow this convention. It degrades to a working
+ * link in every plain markdown renderer and in every document exporter
+ * (DOCX/PDF/EPUB), and renderers that know the convention swap in the
+ * provider's player. A link inside prose stays a link: only a paragraph made of
+ * nothing else is an embed. An `<iframe>` embed snippet copied from a provider's
+ * Share → Embed dialog is recognized too ({@link findBlockVideoEmbed} on an
+ * `htmlBlock`, {@link parseVideoEmbedInput} for pasted text).
+ *
+ * The iframe `src` is ALWAYS rebuilt from validated parts — provider, an id
+ * matched against the provider's id grammar, a whole-second start offset — on a
+ * fixed provider origin. An author's URL never reaches an iframe, which is what
+ * lets the HTML sanitizer admit these iframes while it drops every other one.
+ */
+
+type VideoEmbedProviderId = 'youtube' | 'vimeo' | 'loom' | 'dailymotion' | 'wistia';
+/** Display facts about a supported provider, for pickers and help text. */
+interface VideoEmbedProviderInfo {
+    id: VideoEmbedProviderId;
+    /** Human-readable name, e.g. `YouTube`. */
+    name: string;
+    /** A representative page URL, for placeholder and help text. */
+    example: string;
+}
+/** The supported providers, in the order UI should list them. */
+declare const VIDEO_EMBED_PROVIDERS: readonly VideoEmbedProviderInfo[];
+/** A recognized hosted video, normalized. */
+interface VideoEmbed {
+    provider: VideoEmbedProviderId;
+    /** Human-readable provider name, e.g. `YouTube`. */
+    providerName: string;
+    /**
+     * The provider's id for what plays: a video id, or — for a YouTube
+     * playlist link with no video — the playlist id.
+     */
+    id: string;
+    /** YouTube playlist the video plays within, when the URL named one. */
+    playlistId?: string;
+    /** The player URL for an `<iframe src>`. Rebuilt from validated parts. */
+    embedUrl: string;
+    /**
+     * The canonical page URL: what a markdown link should point at. Tracking
+     * parameters (`si=`, `feature=`, `pp=` …) are dropped; the start offset and
+     * playlist are kept. An embed-only URL (`/embed/<id>`) maps back to the
+     * watch page, so a pasted iframe still degrades to a link a reader can open.
+     */
+    watchUrl: string;
+    /** Start offset in whole seconds, when the URL carried one. */
+    startSeconds?: number;
+    /**
+     * A still poster image, when the provider serves one at a predictable URL
+     * with no API call (YouTube, Dailymotion). Remote — callers that must stay
+     * offline should not fetch it.
+     */
+    thumbnailUrl?: string;
+    /** Frame width ÷ height: 16/9, or 9/16 for YouTube Shorts. */
+    aspectRatio: number;
+}
+/** A block that should render as a hosted-video player. */
+interface BlockVideoEmbed {
+    embed: VideoEmbed;
+    /**
+     * The author's label for the video — the link text — or null when the
+     * paragraph is a bare URL. For an `<iframe>` block it is the iframe's
+     * `title`, unless that is a provider's generic "… video player" title.
+     */
+    title: string | null;
+    /** How the block was written. */
+    form: 'link' | 'url' | 'iframe';
+}
+/**
+ * A start offset as providers write it — `90`, `90s`, `1m30s`, `1h2m3s`,
+ * `1:30`, `1:02:03` — in whole seconds; undefined when absent, zero or
+ * unreadable.
+ */
+declare function parseVideoStartTime(raw: string | null | undefined): number | undefined;
+/**
+ * Recognize a hosted-video page or player URL. Accepts the forms people paste:
+ * scheme-less (`youtu.be/…`), protocol-relative (`//player.vimeo.com/…`), the
+ * `<…>` autolink form, and markdown-escaped destinations. Returns null for
+ * anything that is not a playable video on a supported provider — a channel,
+ * a search page, a malformed id.
+ */
+declare function parseVideoEmbedUrl(input: string | null | undefined): VideoEmbed | null;
+/** Whether `input` is a hosted-video URL {@link parseVideoEmbedUrl} recognizes. */
+declare function isVideoEmbedUrl(input: string | null | undefined): boolean;
+/** The value a player iframe's `allow` attribute carries. */
+declare const VIDEO_EMBED_IFRAME_ALLOW = "accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share; fullscreen";
+/**
+ * The complete attribute set for a player `<iframe>` — the ONE definition
+ * every renderer and exporter emits, so a sanitized iframe and a rendered link
+ * paragraph produce the same element. Attribute names are HTML (lowercase).
+ *
+ * `referrerpolicy` matters: YouTube refuses to play ("Error 153") when an
+ * embed request carries no referrer.
+ */
+declare function videoEmbedIframeAttributes(embed: VideoEmbed, title?: string | null): Record<string, string>;
+/**
+ * Recognize a provider iframe element (the sanitizer's entry point). Null when
+ * its `src` is not a supported video.
+ */
+declare function videoEmbedFromIframe(element: HtmlElement): {
+    embed: VideoEmbed;
+    title: string | null;
+} | null;
+/**
+ * What a person pasted or typed where a video is expected: a page URL, or a
+ * provider's `<iframe>` embed code. Null when it is neither.
+ */
+declare function parseVideoEmbedInput(input: string | null | undefined): {
+    embed: VideoEmbed;
+    title: string | null;
+} | null;
+/**
+ * The hosted video a block stands for, or null:
+ *
+ *  - a paragraph whose only content is one link to a video page
+ *    (`[title](url)`; `title` is the link text unless that is itself a URL);
+ *  - a paragraph whose whole text is one video URL (a bare URL, which GFM
+ *    autolinks — read from the text so an autolink that stopped short of a
+ *    trailing `_` in the id is still recognized);
+ *  - an HTML block holding a single provider `<iframe>` (pasted embed code).
+ *
+ * A link with surrounding prose is not an embed. Renderers ask this of
+ * TOP-LEVEL blocks only: a video link in a list item or blockquote is a list
+ * of links, not a stack of players. (Explicit `<iframe>` code is honored
+ * wherever it appears.)
+ */
+declare function findBlockVideoEmbed(node: MarkdownBlockNode): BlockVideoEmbed | null;
+
 /**
  * Caller-owned policy for resources referenced by a document.
  *
@@ -633,11 +774,20 @@ declare function rewriteMarkdownReferences(source: string, options?: MarkdownRef
 interface DocfxMarkdownOptions {
     /** Image omission retains descriptive alt text. */
     images?: 'preserve' | 'omit';
+    /** Retain invalid or unsupported source metadata visibly without interpreting it. */
+    frontmatterAsCode?: boolean;
+    /** Resolve code transclusions and UID references without fetching in core. */
+    reference?: (kind: 'code' | 'xref', target: string, label: string) => string;
+    /** Preserve unsupported presentation markers as visible inline code. */
+    unknownDirectives?: 'error' | 'preserve';
+    /** Report malformed references retained verbatim as code in preservation mode. */
+    onPreservedReference?: (source: string) => void;
 }
 /** Convert presentational DocFX directives to portable Markdown without fetching.
  * Includes and code transclusions remain the source adapter's responsibility.
  * All zone variants are retained with their pivot labels. Code examples and
- * frontmatter remain untouched. Unsupported directives throw instead of losing text.
+ * frontmatter remain untouched by default. Hosts can preserve unsupported syntax
+ * and metadata visibly through the explicit preservation options.
  */
 declare function normalizeDocfxMarkdown(source: string, options?: DocfxMarkdownOptions): string;
 
@@ -650,4 +800,20 @@ declare function normalizeDocfxMarkdown(source: string, options?: DocfxMarkdownO
  */
 declare function condenseMarkdownSource(source: string): string;
 
-export { DEFAULT_INTERACTIVE_RESOURCE_POLICY, DEFAULT_RESOURCE_MAX_BYTES, DEFAULT_RESOURCE_TIMEOUT_MS, DEFAULT_WRAP_WIDTH, type DocfxMarkdownOptions, type FetchResourceBytesOptions, type FetchedResource, HeadingAttributes, HtmlNode, type HtmlPolicy, LOCAL_ONLY_RESOURCE_POLICY, MARKDOWN_SOURCE_TRANSFORMS, MarkdownDocument, MarkdownNode, type MarkdownReferenceOptions, type MarkdownSourceEdit, type MarkdownSourceTransform, type MarkdownSourceTransformId, type MarkdownSourceTransformOptions, type MarkdownSourceTransformResult, type MarkdownWrapState, ParseOptions, type ResourcePolicy, ResourcePolicyError, type SanitizeUrlOptions, StringifyOptions, type TrailingAnnotationMatch, type UrlKind, applyMarkdownSourceTransform, cleanupMarkdownSource, condenseMarkdownSource, countNodes, createDocument, detectMarkdownWrapState, extractPlainText, fetchResourceBytes, findNodesByType, formatBlockScalar, formatFrontmatterValue, formatFrontmatterYaml, fromMdast, getChildren, inferDocumentTitle, isResourceUrlAllowed, matchTrailingPandocAttr, matchTrailingTemplateAnnotation, needsQuoting, normalizeDocfxMarkdown, parseFrontmatter, parseHtmlToNodes, parseMarkdown, parsePandocAttrTokens, plainTextFromInlineHtml, quoteAttrValue, readFrontmatterThemeId, rewriteMarkdownReferences, sanitizeHtmlNodes, sanitizeUrl, serializePandocAttributes, setFrontmatterValues, splitFrontmatterBlock, splitKeyValueToken, stringifyHtmlNodes, stringifyMarkdown, toMdast, tokenizeAttrTokens, unquoteAttrValue, unwrapMarkdownSource, walkMarkdownTree, wrapMarkdownSource };
+/**
+ * What a markdown media reference points at. Image syntax is the only
+ * embedding markdown has, so documents written for a library that ships
+ * clips and recordings (knowledge catalogs, recorder output) reference them
+ * as `![A brass bell ringing](sounds/bell.mp3)` — and a renderer that drew
+ * every such reference as an `<img>` showed a broken picture.
+ *
+ * The decision is by file extension, ignoring any query string or fragment.
+ * `.webm` and `.mp4` are containers for either; like narration discovery
+ * (`audioMapping.ts`), they count as audio only under the `audio/` folder
+ * the recorder writes to, and as video everywhere else.
+ */
+type MediaReferenceKind = 'video' | 'audio';
+/** `'video'`, `'audio'`, or null for anything else (an image, a page, no extension). */
+declare function mediaKindForUrl(url: string): MediaReferenceKind | null;
+
+export { type BlockVideoEmbed, DEFAULT_INTERACTIVE_RESOURCE_POLICY, DEFAULT_RESOURCE_MAX_BYTES, DEFAULT_RESOURCE_TIMEOUT_MS, DEFAULT_WRAP_WIDTH, type DocfxMarkdownOptions, type FetchResourceBytesOptions, type FetchedResource, HeadingAttributes, HtmlElement, HtmlNode, type HtmlPolicy, LOCAL_ONLY_RESOURCE_POLICY, MARKDOWN_SOURCE_TRANSFORMS, MarkdownBlockNode, MarkdownDocument, MarkdownNode, type MarkdownReferenceOptions, type MarkdownSourceEdit, type MarkdownSourceTransform, type MarkdownSourceTransformId, type MarkdownSourceTransformOptions, type MarkdownSourceTransformResult, type MarkdownWrapState, type MediaReferenceKind, ParseOptions, type ResourcePolicy, ResourcePolicyError, type SanitizeUrlOptions, StringifyOptions, type TrailingAnnotationMatch, type UrlKind, VIDEO_EMBED_IFRAME_ALLOW, VIDEO_EMBED_PROVIDERS, type VideoEmbed, type VideoEmbedProviderId, type VideoEmbedProviderInfo, applyMarkdownSourceTransform, cleanupMarkdownSource, condenseMarkdownSource, countNodes, createDocument, detectMarkdownWrapState, extractPlainText, fetchResourceBytes, findBlockVideoEmbed, findNodesByType, formatBlockScalar, formatFrontmatterValue, formatFrontmatterYaml, fromMdast, getChildren, inferDocumentTitle, isResourceUrlAllowed, isVideoEmbedUrl, matchTrailingPandocAttr, matchTrailingTemplateAnnotation, mediaKindForUrl, needsQuoting, normalizeDocfxMarkdown, parseFrontmatter, parseHtmlToNodes, parseMarkdown, parsePandocAttrTokens, parseVideoEmbedInput, parseVideoEmbedUrl, parseVideoStartTime, plainTextFromInlineHtml, quoteAttrValue, readFrontmatterThemeId, rewriteMarkdownReferences, sanitizeHtmlNodes, sanitizeUrl, serializePandocAttributes, setFrontmatterValues, splitFrontmatterBlock, splitKeyValueToken, stringifyHtmlNodes, stringifyMarkdown, toMdast, tokenizeAttrTokens, unquoteAttrValue, unwrapMarkdownSource, videoEmbedFromIframe, videoEmbedIframeAttributes, walkMarkdownTree, wrapMarkdownSource };

package/dist/markdown/index.js

@@ -17,7 +17,7 @@ import {
   stringifyMarkdown,
   unwrapMarkdownSource,
   wrapMarkdownSource
-} from "../chunk-ANH2OZ2M.js";
+} from "../chunk-LJZHC6GN.js";
 import {
   DEFAULT_MARKDOWN_SAFETY_LIMITS,
   MarkdownLimitError,
@@ -29,7 +29,7 @@ import {
   resolveMarkdownSafetyLimits,
   serializePandocAttributes,
   toMdast
-} from "../chunk-GDHXT5Q7.js";
+} from "../chunk-PGWYC3S2.js";
 import {
   BLOCK_META_KEY_DESCRIPTORS,
   KNOWN_BLOCK_META_KEYS,
@@ -43,26 +43,36 @@ import {
   splitKeyValueToken,
   tokenizeAttrTokens,
   unquoteAttrValue
-} from "../chunk-TMOHAFYE.js";
+} from "../chunk-WSFXV5BT.js";
 import {
+  VIDEO_EMBED_IFRAME_ALLOW,
+  VIDEO_EMBED_PROVIDERS,
   countNodes,
   createDocument,
   extractPlainText,
+  findBlockVideoEmbed,
   findNodesByType,
   formatBlockScalar,
   formatFrontmatterValue,
   formatFrontmatterYaml,
   getChildren,
   inferDocumentTitle,
+  isVideoEmbedUrl,
+  mediaKindForUrl,
   parseFrontmatter,
   parseHtmlToNodes,
+  parseVideoEmbedInput,
+  parseVideoEmbedUrl,
+  parseVideoStartTime,
   plainTextFromInlineHtml,
   readFrontmatterThemeId,
   setFrontmatterValues,
   splitFrontmatterBlock,
   stringifyHtmlNodes,
+  videoEmbedFromIframe,
+  videoEmbedIframeAttributes,
   walkMarkdownTree
-} from "../chunk-X7BNDUNI.js";
+} from "../chunk-Q6ELOAOQ.js";
 import "../chunk-7N4G32LG.js";
 import "../chunk-4VOD55SX.js";
 export {
@@ -77,6 +87,8 @@ export {
   MARKDOWN_SOURCE_TRANSFORMS,
   MarkdownLimitError,
   ResourcePolicyError,
+  VIDEO_EMBED_IFRAME_ALLOW,
+  VIDEO_EMBED_PROVIDERS,
   applyMarkdownSourceTransform,
   assertMarkdownDocumentWithinLimits,
   assertMarkdownSourceWithinLimits,
@@ -87,6 +99,7 @@ export {
   detectMarkdownWrapState,
   extractPlainText,
   fetchResourceBytes,
+  findBlockVideoEmbed,
   findNodesByType,
   formatBlockScalar,
   formatFrontmatterValue,
@@ -95,8 +108,10 @@ export {
   getChildren,
   inferDocumentTitle,
   isResourceUrlAllowed,
+  isVideoEmbedUrl,
   matchTrailingPandocAttr,
   matchTrailingTemplateAnnotation,
+  mediaKindForUrl,
   needsQuoting,
   normalizeDocfxMarkdown,
   parseFrontmatter,
@@ -104,6 +119,9 @@ export {
   parseMarkdown,
   parsePandocAttrTokens,
   parseTimeSeconds,
+  parseVideoEmbedInput,
+  parseVideoEmbedUrl,
+  parseVideoStartTime,
   plainTextFromInlineHtml,
   quoteAttrValue,
   readFrontmatterThemeId,
@@ -121,6 +139,8 @@ export {
   tokenizeAttrTokens,
   unquoteAttrValue,
   unwrapMarkdownSource,
+  videoEmbedFromIframe,
+  videoEmbedIframeAttributes,
   walkMarkdownTree,
   wrapMarkdownSource
 };

package/dist/{materializePageSection-FRv9whYy.d.ts → materializePageSection-IYXU3tDN.d.ts}

@@ -1,4 +1,4 @@
-import { k as Block, aT as PageSectionKind, aR as PageEmphasis, by as ThemeColorScheme, aP as PageBackground, bw as Theme, b$ as ViewportConfig, y as CustomTemplateDefinition, aW as PageVariant, bk as StartBlockConfig, Q as Doc, bz as ThemePageStyle } from './Doc-Bd2kdzuy.js';
+import { k as Block, aT as PageSectionKind, aR as PageEmphasis, by as ThemeColorScheme, aP as PageBackground, bw as Theme, c0 as ViewportConfig, y as CustomTemplateDefinition, aW as PageVariant, bk as StartBlockConfig, Q as Doc, bz as ThemePageStyle } from './Doc-B6TYHYGc.js';
 import { M as MarkdownBlockNode } from './types-C6VvDDL2.js';
 
 /**
@@ -46,6 +46,11 @@ type PageMedia = {
     clipEnd?: number;
     credit?: string;
     license?: string;
+} | {
+    /** A hosted video (YouTube, Vimeo, …) by its page URL; renderers play it. */
+    type: 'videoEmbed';
+    url: string;
+    title?: string;
 } | {
     type: 'canvas';
     spatial: PageSpatialKind;