@bendyline/squisq 2.11.6 → 2.11.8

package/dist/narration/index.d.ts

@@ -1,4 +1,4 @@
-import { O as Doc, f as AudioBookmark } from '../Doc-BkxT7G80.js';
+import { O as Doc, f as AudioBookmark } from '../Doc-CynsGqL4.js';
 import '../types-Be6sBUBx.js';
 
 /**
@@ -294,19 +294,12 @@ declare function wordIndexAtChar(script: NarrationScript, charOffset: number): n
 declare function wordIndexAtTime(words: WordTiming[], tSec: number): number;
 
 /**
- * Frame feature extraction: full-band RMS, speech-band energy, and
- * zero-crossing rate over hopped (possibly overlapping) frames.
+ * RBJ biquad filters (Audio-EQ-Cookbook closed forms), streaming.
  *
- * Band energy uses two cascaded RBJ biquads — a high-pass at
- * `bandLowHz` and a low-pass at `bandHighHz` (both Q = 1/√2,
- * Audio-EQ-Cookbook closed forms) — rather than an FFT or Goertzel
- * bins: a Butterworth-ish cascade gives a true maximally-flat band in
- * one O(N) pass, and the filter state persists across hops, which is
- * exactly right for streaming (no window-boundary energy jitter).
- * Goertzel measures single frequencies (DTMF-style) — wrong tool for
- * broadband speech energy.
+ * Shared by the narration feature extractor (speech-band energy) and the
+ * media-edit signal chain (high-pass, breath features, K-weighting). State
+ * is explicit so a filter can run block by block with no boundary artifacts.
  */
-
 interface BiquadCoeffs {
     b0: number;
     b1: number;
@@ -320,6 +313,21 @@ interface BiquadState {
     y1: number;
     y2: number;
 }
+
+/**
+ * Frame feature extraction: full-band RMS, speech-band energy, and
+ * zero-crossing rate over hopped (possibly overlapping) frames.
+ *
+ * Band energy uses two cascaded RBJ biquads — a high-pass at
+ * `bandLowHz` and a low-pass at `bandHighHz` (both Q = 1/√2,
+ * Audio-EQ-Cookbook closed forms) — rather than an FFT or Goertzel
+ * bins: a Butterworth-ish cascade gives a true maximally-flat band in
+ * one O(N) pass, and the filter state persists across hops, which is
+ * exactly right for streaming (no window-boundary energy jitter).
+ * Goertzel measures single frequencies (DTMF-style) — wrong tool for
+ * broadband speech energy.
+ */
+
 interface BandpassState {
     coeffs: {
         hp: BiquadCoeffs;

package/dist/narration/index.js

@@ -27,7 +27,8 @@ import {
   recordSlideShown,
   traceWordPosAt,
   vadStep
-} from "../chunk-UUI35INI.js";
+} from "../chunk-5FBI3ZW4.js";
+import "../chunk-NEWNNLWN.js";
 import {
   buildNarrationScript,
   buildNarrationTimingJson,
@@ -37,11 +38,12 @@ import {
   wordIndexAtChar,
   wordIndexAtTime,
   wordPosAtExpectedSyllables
-} from "../chunk-764WHWKM.js";
-import "../chunk-WAGJK36Q.js";
-import "../chunk-PUS54YU6.js";
+} from "../chunk-ZEONJCP3.js";
+import "../chunk-RMCUZDW5.js";
 import "../chunk-C3NAY5YP.js";
+import "../chunk-PUS54YU6.js";
 import "../chunk-Y4D6TDZT.js";
+import "../chunk-L7QZORLB.js";
 import "../chunk-TMOHAFYE.js";
 import "../chunk-X7BNDUNI.js";
 import "../chunk-4VOD55SX.js";

package/dist/schemas/index.d.ts

@@ -1,10 +1,10 @@
 export { B as BoundingBox, C as Coordinates } from '../Types-sh2VRxfo.js';
-import { O as Doc, bh as Theme, bk as ThemePageStyle, bj as ThemeColorScheme, I as DeepPartial, bn as ThemeSeedColors, bi as ThemeColorPalette, X as FontFamilyKind, W as FontFamily } from '../Doc-BkxT7G80.js';
-export { A as AccentImage, a as AccentPosition, b as AmbientGradientConfig, c as Animation, d as AnimationType, e as AreaChartInput, f as AudioBookmark, g as AudioSegment, h as AudioTimingData, i as AudioTrack, B as BarChartInput, j as BigTextInput, k as Block, l as BlockConnection, m as BorderStyle, C as CaptionPhrase, n as CaptionTrack, o as CaptionWord, p as ChartBaseFields, q as ChartTemplateInput, r as ColorScheme, s as ColumnChartInput, t as ComparisonBarInput, u as ContentBlockInput, v as CornerBrandingConfig, w as CustomTemplateDefinition, x as CustomTemplateLayer, y as CustomTemplateValidationError, z as CustomTemplateValidationResult, D as DARK_SURFACE, E as DEFAULT_DOC_FONT, F as DEFAULT_TITLE_FONT, G as DataTableInput, H as DateEventInput, J as DefinitionCardInput, K as DiagramBlockInput, L as DiagramEdgeAnchor, M as DiagramTemplateEdge, N as DiagramTemplateNode, P as DocBlock, Q as DocDiagnostic, R as DonutChartInput, S as DrawingBlockInput, T as FRONTMATTER_CUSTOM_TEMPLATES_KEY, U as FRONTMATTER_CUSTOM_THEMES_KEY, V as FactCardInput, Y as FullBleedQuoteInput, Z as GradientBackgroundConfig, _ as ImageBackgroundConfig, $ as ImageLayer, a0 as ImageTreatment, a1 as ImageWithCaptionInput, a2 as LIGHT_SURFACE, a3 as Layer, a4 as LayerRepeat, a5 as LayoutHints, a6 as LeftFeatureInput, a7 as LineChartInput, a8 as LinearGradient, a9 as ListBlockInput, aa as MapBlockInput, ab as MapLayer, ac as MapMarker, ad as MapTileStyle, ae as MarkerStyle, af as MediaClip, ag as MediaScheduleOptions, ah as MermaidLayer, ai as PAGE_ACCENT_STRATEGIES, aj as PAGE_BACKGROUNDS, ak as PAGE_BACKGROUND_RHYTHMS, al as PAGE_DESIGN_FAMILIES, am as PAGE_DIVIDERS, an as PAGE_EMPHASES, ao as PAGE_EYEBROWS, ap as PAGE_HEADING_CASES, aq as PAGE_HEADING_SCALES, ar as PAGE_HEADING_UNDERLINES, as as PAGE_HERO_STYLES, at as PAGE_IMAGE_FRAMINGS, au as PAGE_NUMERAL_STYLES, av as PAGE_PATTERNS, aw as PAGE_QUOTE_MARKS, ax as PAGE_SECTION_KINDS, ay as PAGE_SECTION_SPACINGS, az as PAGE_SHADOWS, aA as PageAccentRotation, aB as PageBackground, aC as PageDesignFamily, aD as PageEmphasis, aE as PageHeadingTreatment, aF as PageSectionKind, aG as PageSectionOverride, aH as PageTokens, aI as PathLayer, aJ as PatternBackgroundConfig, aK as PersistentLayer, aL as PersistentLayerConfig, aM as PersistentLayerTemplate, aN as PersistentLayerTemplateConfig, aO as PersistentLayerTemplateType, aP as PhotoGridInput, aQ as PieChartInput, aR as PipStyle, aS as Position, aT as ProgressIndicatorConfig, aU as PromotedBodyAnnotation, aV as PullQuoteInput, aW as QuoteBlockInput, aX as RawLayersInput, aY as RenderStyle, aZ as RightFeatureInput, a_ as ScatterChartInput, a$ as ScheduledClip, b0 as SectionHeaderInput, b1 as ShapeFilter, b2 as ShapeLayer, b3 as ShapePattern, b4 as SolidBackgroundConfig, b5 as StartBlockConfig, b6 as StatHighlightInput, b7 as SurfaceScheme, b8 as THEME_SCHEMA_VERSION, b9 as TableLayer, ba as TableLayerStyle, bb as TemplateBlock, bc as TemplateContext, bd as TemplateFunction, be as TemplateRegistry, bf as TextLayer, bg as TextStyle, bl as ThemeRegistry, bm as ThemeSchemaVersion, bo as ThemeStyle, bp as ThemeTypography, bq as TimelineBlockInput, br as TimelineTemplateEvent, bs as TimelineTemplateLink, bt as TimelineTemplateTrack, bu as TitleBlockInput, bv as TitleCaptionConfig, bw as TranscriptBlockInput, bx as TreeBlockInput, by as TreeLayer, bz as TreeLayerItem, bA as TreeLayerStyle, bB as TreeTemplateItem, bC as TwoColumnInput, bD as VIEWPORT_PRESETS, bE as VideoLayer, bF as VideoPipPosition, bG as VideoPipShape, bH as VideoPipSize, bI as VideoPlacement, bJ as VideoPresentation, bK as VideoPullQuoteInput, bL as VideoWithCaptionInput, bM as ViewportConfig, bN as ViewportOrientation, bO as ViewportPreset, bP as VignetteConfig, bQ as applySurface, bR as calculateDuration, bS as calculateFontScale, bT as createTemplateContext, bU as createTheme, bV as createThemeRegistry, bW as getAspectRatioString, bX as getBlockAtTime, bY as getCaptionAtTime, bZ as getDocPlaybackDuration, b_ as getLayoutHints, b$ as getSafeTextBounds, c0 as getSegmentAtTime, c1 as getTwoColumnPositions, c2 as getViewport, c3 as getViewportOrientation, c4 as isCustomTemplateDefinition, c5 as isPersistentLayerTemplate, c6 as isTemplateBlock, c7 as layoutScaledFontSize, c8 as resolveMediaSchedule, c9 as scaledFontSize, ca as validateCustomTemplateDefinition } from '../Doc-BkxT7G80.js';
+import { O as Doc, bk as Theme, bn as ThemePageStyle, bm as ThemeColorScheme, I as DeepPartial, bq as ThemeSeedColors, bl as ThemeColorPalette, X as FontFamilyKind, W as FontFamily } from '../Doc-CynsGqL4.js';
+export { A as AccentImage, a as AccentPosition, b as AmbientGradientConfig, c as Animation, d as AnimationType, e as AreaChartInput, f as AudioBookmark, g as AudioSegment, h as AudioTimingData, i as AudioTrack, B as BarChartInput, j as BigTextInput, k as Block, l as BlockConnection, m as BorderStyle, C as CaptionPhrase, n as CaptionTrack, o as CaptionWord, p as ChartBaseFields, q as ChartTemplateInput, r as ColorScheme, s as ColumnChartInput, t as ComparisonBarInput, u as ContentBlockInput, v as CornerBrandingConfig, w as CustomTemplateDefinition, x as CustomTemplateLayer, y as CustomTemplateValidationError, z as CustomTemplateValidationResult, D as DARK_SURFACE, E as DEFAULT_DOC_FONT, F as DEFAULT_TITLE_FONT, G as DataTableInput, H as DateEventInput, J as DefinitionCardInput, K as DiagramBlockInput, L as DiagramEdgeAnchor, M as DiagramTemplateEdge, N as DiagramTemplateNode, P as DocBlock, Q as DocDiagnostic, R as DonutChartInput, S as DrawingBlockInput, T as FRONTMATTER_CUSTOM_TEMPLATES_KEY, U as FRONTMATTER_CUSTOM_THEMES_KEY, V as FactCardInput, Y as FullBleedQuoteInput, Z as GradientBackgroundConfig, _ as ImageBackgroundConfig, $ as ImageLayer, a0 as ImageTreatment, a1 as ImageWithCaptionInput, a2 as LIGHT_SURFACE, a3 as Layer, a4 as LayerRepeat, a5 as LayoutHints, a6 as LeftFeatureInput, a7 as LineChartInput, a8 as LinearGradient, a9 as ListBlockInput, aa as MapBlockInput, ab as MapLayer, ac as MapMarker, ad as MapTileStyle, ae as MarkerStyle, af as MediaClip, ag as MediaCrop, ah as MediaCut, ai as MediaEdits, aj as MediaScheduleOptions, ak as MermaidLayer, al as PAGE_ACCENT_STRATEGIES, am as PAGE_BACKGROUNDS, an as PAGE_BACKGROUND_RHYTHMS, ao as PAGE_DESIGN_FAMILIES, ap as PAGE_DIVIDERS, aq as PAGE_EMPHASES, ar as PAGE_EYEBROWS, as as PAGE_HEADING_CASES, at as PAGE_HEADING_SCALES, au as PAGE_HEADING_UNDERLINES, av as PAGE_HERO_STYLES, aw as PAGE_IMAGE_FRAMINGS, ax as PAGE_NUMERAL_STYLES, ay as PAGE_PATTERNS, az as PAGE_QUOTE_MARKS, aA as PAGE_SECTION_KINDS, aB as PAGE_SECTION_SPACINGS, aC as PAGE_SHADOWS, aD as PageAccentRotation, aE as PageBackground, aF as PageDesignFamily, aG as PageEmphasis, aH as PageHeadingTreatment, aI as PageSectionKind, aJ as PageSectionOverride, aK as PageTokens, aL as PathLayer, aM as PatternBackgroundConfig, aN as PersistentLayer, aO as PersistentLayerConfig, aP as PersistentLayerTemplate, aQ as PersistentLayerTemplateConfig, aR as PersistentLayerTemplateType, aS as PhotoGridInput, aT as PieChartInput, aU as PipStyle, aV as Position, aW as ProgressIndicatorConfig, aX as PromotedBodyAnnotation, aY as PullQuoteInput, aZ as QuoteBlockInput, a_ as RawLayersInput, a$ as RenderStyle, b0 as RightFeatureInput, b1 as ScatterChartInput, b2 as ScheduledClip, b3 as SectionHeaderInput, b4 as ShapeFilter, b5 as ShapeLayer, b6 as ShapePattern, b7 as SolidBackgroundConfig, b8 as StartBlockConfig, b9 as StatHighlightInput, ba as SurfaceScheme, bb as THEME_SCHEMA_VERSION, bc as TableLayer, bd as TableLayerStyle, be as TemplateBlock, bf as TemplateContext, bg as TemplateFunction, bh as TemplateRegistry, bi as TextLayer, bj as TextStyle, bo as ThemeRegistry, bp as ThemeSchemaVersion, br as ThemeStyle, bs as ThemeTypography, bt as TimelineBlockInput, bu as TimelineTemplateEvent, bv as TimelineTemplateLink, bw as TimelineTemplateTrack, bx as TitleBlockInput, by as TitleCaptionConfig, bz as TranscriptBlockInput, bA as TreeBlockInput, bB as TreeLayer, bC as TreeLayerItem, bD as TreeLayerStyle, bE as TreeTemplateItem, bF as TwoColumnInput, bG as VIEWPORT_PRESETS, bH as VideoLayer, bI as VideoPipPosition, bJ as VideoPipShape, bK as VideoPipSize, bL as VideoPlacement, bM as VideoPresentation, bN as VideoPullQuoteInput, bO as VideoWithCaptionInput, bP as ViewportConfig, bQ as ViewportOrientation, bR as ViewportPreset, bS as VignetteConfig, bT as applySurface, bU as calculateDuration, bV as calculateFontScale, bW as createTemplateContext, bX as createTheme, bY as createThemeRegistry, bZ as getAspectRatioString, b_ as getBlockAtTime, b$ as getCaptionAtTime, c0 as getDocPlaybackDuration, c1 as getLayoutHints, c2 as getSafeTextBounds, c3 as getSegmentAtTime, c4 as getTwoColumnPositions, c5 as getViewport, c6 as getViewportOrientation, c7 as isCustomTemplateDefinition, c8 as isPersistentLayerTemplate, c9 as isTemplateBlock, ca as layoutScaledFontSize, cb as resolveMediaSchedule, cc as scaledFontSize, cd as scheduleMediaClip, ce as validateCustomTemplateDefinition } from '../Doc-CynsGqL4.js';
 export { a as DEFAULT_TRANSITION_DURATION_SECONDS, a1 as TRANSITION_DIRECTIONS, a2 as TRANSITION_TYPES, a3 as Transition, a4 as TransitionDirection, a5 as TransitionType, a8 as isTransitionType, a9 as normalizeTransitionDirection, aa as normalizeTransitionType, ab as resolveBlockTransition, ad as resolveTransitionDuration } from '../types-Be6sBUBx.js';
-export { D as DEFAULT_THEME, a as DEFAULT_THEME_ID, T as THEMES, g as getAvailableThemes, b as getThemeSummaries, r as resolveTheme } from '../themeLibrary-BbSjnGmd.js';
+export { D as DEFAULT_THEME, a as DEFAULT_THEME_ID, T as THEMES, g as getAvailableThemes, b as getThemeSummaries, r as resolveTheme } from '../themeLibrary-z7t3x5CU.js';
 export { M as MediaEntry, a as MediaProvider } from '../MediaProvider-wpSe21B3.js';
-export { E as EditorLayerMeta, I as ImageEditCanvas, a as ImageEditDoc, b as ImageEditLayer, c as ImageEditLayerKind, d as ImageEditMeta } from '../ImageEditDoc-C8ZB54Vv.js';
+export { E as EditorLayerMeta, I as ImageEditCanvas, a as ImageEditDoc, b as ImageEditLayer, c as ImageEditLayerKind, d as ImageEditMeta } from '../ImageEditDoc-BVZe_5y4.js';
 
 /**
  * Runtime validation for the canonical {@link Doc} JSON shape.

package/dist/schemas/index.js

@@ -13,12 +13,13 @@ import {
   pipStyleVars,
   serializeTheme,
   validateDocSchema
-} from "../chunk-BUJ5RV2P.js";
+} from "../chunk-JJO6JFNZ.js";
 import {
   defaultPageStyle,
   getDocPlaybackDuration,
-  resolveMediaSchedule
-} from "../chunk-GAZKTT4R.js";
+  resolveMediaSchedule,
+  scheduleMediaClip
+} from "../chunk-YNO6JV36.js";
 import {
   AVAILABLE_FONT_STACKS,
   DARK_SURFACE,
@@ -90,6 +91,8 @@ import {
   validateTheme,
   withAlpha
 } from "../chunk-Y4D6TDZT.js";
+import "../chunk-JSGIWW35.js";
+import "../chunk-L7QZORLB.js";
 import {
   DEFAULT_TRANSITION_DURATION_SECONDS,
   TRANSITION_DIRECTIONS,
@@ -190,6 +193,7 @@ export {
   resolveTheme,
   resolveTransitionDuration,
   scaledFontSize2 as scaledFontSize,
+  scheduleMediaClip,
   serializeTheme,
   validateCustomTemplateDefinition,
   validateDocSchema,

package/dist/{themeLibrary-BbSjnGmd.d.ts → themeLibrary-z7t3x5CU.d.ts}

@@ -1,4 +1,4 @@
-import { bh as Theme, bl as ThemeRegistry } from './Doc-BkxT7G80.js';
+import { bk as Theme, bo as ThemeRegistry } from './Doc-CynsGqL4.js';
 
 /**
  * Built-in Theme Library

package/dist/timing/index.d.ts

@@ -1,4 +1,4 @@
-import { g as AudioSegment, h as AudioTimingData, n as CaptionTrack } from '../Doc-BkxT7G80.js';
+import { g as AudioSegment, h as AudioTimingData, n as CaptionTrack } from '../Doc-CynsGqL4.js';
 import '../types-Be6sBUBx.js';
 
 /**

package/dist/transform/index.d.ts

@@ -1,5 +1,5 @@
-import { O as Doc, r as ColorScheme, k as Block, bb as TemplateBlock } from '../Doc-BkxT7G80.js';
-import { i as PageTransformHints } from '../materializePageSection-Dp2aHFbc.js';
+import { O as Doc, r as ColorScheme, k as Block, be as TemplateBlock } from '../Doc-CynsGqL4.js';
+import { i as PageTransformHints } from '../materializePageSection-CAJoa8fh.js';
 import { d as ExtractionType, E as ExtractedElement, b as ExtractionOptions } from '../contentExtractor-BNfVJV2U.js';
 import '../types-Be6sBUBx.js';
 
@@ -151,6 +151,26 @@ declare function applyTransform(doc: Doc, style: TransformStyleInput, options?:
  * Converts a narrated text segment and its media into a timed Doc using the
  * canonical squisq transform pipeline. This is the reusable bridge for hosts
  * that generate one visual sequence per narration segment.
+ *
+ * Pacing: a narrated segment is a single source block, so the text transform
+ * alone promotes only one or two extractions — a 60s segment would become one
+ * 60s slide, which timed players (`expandDocBlocks`) then split into repeated
+ * copies of that same slide. `paceSegment()` restores a visual rhythm: it aims
+ * for `slidesPerMinute`, places up to `maxVideos` clips, and fills the rest
+ * with standalone image slides until no slide runs past `maxSlideDuration`
+ * (or the images run out). Image-poor segments get more text slides instead:
+ * their narration is split into sentence runs, one source block each, since
+ * the transform promotes at most one extraction per type from a block.
+ *
+ * The output timeline is sequential and unanchored: content blocks are ORDERED
+ * by where their extraction is spoken, but carry no `sourceStartTime`. When a
+ * segment mixes anchored and floating blocks, `expandDocBlocks()` hoists every
+ * anchored block ahead of the floating ones and stretches whatever precedes
+ * the first anchor (typically a host's section header), so a fully sequential
+ * segment is the only shape that survives re-timing by hosts and players.
+ *
+ * Block ids are prefixed with the segment id so segments composed into one
+ * Doc never collide (the transform itself numbers from `transform-0`).
  */
 
 interface NarratedSegmentVideo {
@@ -179,7 +199,21 @@ interface NarratedSegmentTransformOptions extends Pick<TransformOptions, 'themeI
     style?: TransformStyleInput;
     seed?: number;
     minConfidence?: number;
+    /**
+     * Visual pace target. Also caps the text transform's promotions when set.
+     * Pacing defaults to 5 when omitted.
+     */
     slidesPerMinute?: number;
+    /** Longest a slide should hold before another visual is added. Default 15s. */
+    maxSlideDuration?: number;
+    /**
+     * Shortest slide the pacer schedules; bounds the slide count so timed
+     * players don't merge slides back together (they fold anything under ~5s).
+     * Default 6s.
+     */
+    minSlideDuration?: number;
+    /** Most video clips placed in one segment. Default 2. */
+    maxVideos?: number;
 }
 interface NarratedSegmentResult extends TransformResult {
     seed: number;

package/dist/transform/index.js

@@ -9,16 +9,17 @@ import {
   getTransformStyleSummaries,
   resolveTransformStyle,
   transformNarratedSegment
-} from "../chunk-J2IPSQKP.js";
+} from "../chunk-KFZOCWPK.js";
 import "../chunk-SVN7T6BK.js";
-import "../chunk-WAGJK36Q.js";
-import "../chunk-PUS54YU6.js";
+import "../chunk-RMCUZDW5.js";
 import "../chunk-C3NAY5YP.js";
+import "../chunk-PUS54YU6.js";
 import "../chunk-Y4D6TDZT.js";
-import "../chunk-CW24CH7I.js";
+import "../chunk-L7QZORLB.js";
+import "../chunk-HUXK7EOT.js";
 import "../chunk-TMOHAFYE.js";
-import "../chunk-7N4G32LG.js";
 import "../chunk-X7BNDUNI.js";
+import "../chunk-7N4G32LG.js";
 import "../chunk-4VOD55SX.js";
 import "../chunk-GHOPHGOK.js";
 import "../chunk-XRW6P7IF.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bendyline/squisq",
-  "version": "2.11.6",
+  "version": "2.11.8",
   "description": "Headless utilities for doc/block rendering, spatial math, Markdown, and storage",
   "license": "MIT",
   "author": "Bendyline",
@@ -102,6 +102,11 @@
       "import": "./dist/imageEdit/index.js",
       "default": "./dist/imageEdit/index.js"
     },
+    "./mediaEdit": {
+      "types": "./dist/mediaEdit/index.d.ts",
+      "import": "./dist/mediaEdit/index.js",
+      "default": "./dist/mediaEdit/index.js"
+    },
     "./icons": {
       "types": "./dist/icons/index.d.ts",
       "import": "./dist/icons/index.js",

package/dist/{chunk-CW24CH7I.js → chunk-HUXK7EOT.js}

@@ -7,13 +7,13 @@ import {
   splitKeyValueToken,
   tokenizeAttrTokens
 } from "./chunk-TMOHAFYE.js";
-import {
-  resolveIcon
-} from "./chunk-7N4G32LG.js";
 import {
   parseFrontmatter,
   parseHtmlToNodes
 } from "./chunk-X7BNDUNI.js";
+import {
+  resolveIcon
+} from "./chunk-7N4G32LG.js";
 
 // src/markdown/convert.ts
 function convertPosition(pos) {