@airalogy/aimd-renderer 2.7.0 → 2.8.0

package/dist/{readonly-record-renderer-CkzY7UvT.js → readonly-record-renderer-G9xOkOFe.js}

@@ -1,4 +1,4 @@
-import { s as T, t as D } from "./processor-BOCQYqXE.js";
+import { s as T, t as D } from "./processor-C_zN3-hL.js";
 import { defineComponent as B, shallowRef as G, ref as $, watch as K, h as d } from "vue";
 const F = ["var", "var_table", "step", "check", "quiz"], Y = {
   file: "FILE",

package/dist/vue/index.d.ts

@@ -7,5 +7,6 @@ export { renderToVue, createRenderer, defaultRenderer, } from '../common/process
 export { createAimdRendererMessages, DEFAULT_AIMD_RENDERER_LOCALE, resolveAimdRendererLocale, } from '../locales';
 export type { RenderContext, RenderMode, ProcessorOptions, } from '@airalogy/aimd-core/types';
 export type { AimdAssignerVisibility, AimdRendererOptions, RenderResult } from '../common/processor';
+export type { AimdAssetUrlResolver, AimdAssetUrlResolveContext, } from '../common/assetUrls';
 export type { AimdRendererI18nOptions, AimdRendererLocale, AimdRendererMessages, AimdRendererMessagesInput, } from '../locales';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/vue/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,mBAAmB,EACnB,uBAAuB,EACvB,uBAAuB,EACvB,sBAAsB,EACtB,qBAAqB,EACrB,sBAAsB,EACtB,oBAAoB,EACpB,KAAK,wBAAwB,EAC7B,KAAK,eAAe,EACpB,SAAS,EACT,cAAc,EACd,KAAK,2BAA2B,EAChC,KAAK,2BAA2B,EAChC,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,GACxB,MAAM,gBAAgB,CAAA;AAEvB,OAAO,EACL,yBAAyB,EACzB,iCAAiC,EACjC,oCAAoC,EACpC,iCAAiC,EACjC,0BAA0B,EAC1B,yBAAyB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC5B,KAAK,iCAAiC,EACtC,KAAK,2BAA2B,EAChC,KAAK,mCAAmC,EACxC,KAAK,gCAAgC,EACrC,KAAK,gCAAgC,GACtC,MAAM,4BAA4B,CAAA;AAEnC,OAAO,EACL,WAAW,EACX,cAAc,EACd,eAAe,GAChB,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EACL,0BAA0B,EAC1B,4BAA4B,EAC5B,yBAAyB,GAC1B,MAAM,YAAY,CAAA;AAEnB,YAAY,EACV,aAAa,EACb,UAAU,EACV,gBAAgB,GACjB,MAAM,2BAA2B,CAAA;AAElC,YAAY,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACpG,YAAY,EACV,uBAAuB,EACvB,kBAAkB,EAClB,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/vue/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,aAAa,EAClB,mBAAmB,EACnB,uBAAuB,EACvB,uBAAuB,EACvB,sBAAsB,EACtB,qBAAqB,EACrB,sBAAsB,EACtB,oBAAoB,EACpB,KAAK,wBAAwB,EAC7B,KAAK,eAAe,EACpB,SAAS,EACT,cAAc,EACd,KAAK,2BAA2B,EAChC,KAAK,2BAA2B,EAChC,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,GACxB,MAAM,gBAAgB,CAAA;AAEvB,OAAO,EACL,yBAAyB,EACzB,iCAAiC,EACjC,oCAAoC,EACpC,iCAAiC,EACjC,0BAA0B,EAC1B,yBAAyB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC5B,KAAK,iCAAiC,EACtC,KAAK,2BAA2B,EAChC,KAAK,mCAAmC,EACxC,KAAK,gCAAgC,EACrC,KAAK,gCAAgC,GACtC,MAAM,4BAA4B,CAAA;AAEnC,OAAO,EACL,WAAW,EACX,cAAc,EACd,eAAe,GAChB,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EACL,0BAA0B,EAC1B,4BAA4B,EAC5B,yBAAyB,GAC1B,MAAM,YAAY,CAAA;AAEnB,YAAY,EACV,aAAa,EACb,UAAU,EACV,gBAAgB,GACjB,MAAM,2BAA2B,CAAA;AAElC,YAAY,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AACpG,YAAY,EACV,oBAAoB,EACpB,0BAA0B,GAC3B,MAAM,qBAAqB,CAAA;AAC5B,YAAY,EACV,uBAAuB,EACvB,kBAAkB,EAClB,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,YAAY,CAAA"}

package/dist/vue/vue-renderer.d.ts

@@ -1,6 +1,7 @@
 import type { Element, Root as HastRoot, RootContent } from "hast";
 import type { Component, VNode, VNodeChild } from "vue";
 import type { AimdNode, RenderContext } from "@airalogy/aimd-core/types";
+import type { AimdAssetUrlResolver } from "../common/assetUrls";
 import type { AimdRendererI18nOptions, AimdRendererLocale, AimdRendererMessages } from "../locales";
 /**
  * Extended Element data type
@@ -20,6 +21,7 @@ export type ElementRenderer = (node: Element, children: VNodeChild[], ctx: AimdR
 export interface AimdRendererContext extends RenderContext {
     locale: AimdRendererLocale;
     messages: AimdRendererMessages;
+    resolveAssetUrl?: AimdAssetUrlResolver;
 }
 export interface AimdStepCardRendererOptions {
     showScopeLabel?: boolean;
@@ -50,7 +52,11 @@ export interface VueRendererOptions {
     /**
      * Render context
      */
-    context?: RenderContext & Partial<Pick<AimdRendererContext, "locale" | "messages">>;
+    context?: RenderContext & Partial<Pick<AimdRendererContext, "locale" | "messages" | "resolveAssetUrl">>;
+    /**
+     * Resolve protocol-local figure assets to displayable URLs.
+     */
+    resolveAssetUrl?: AimdAssetUrlResolver;
     /**
      * Custom AIMD component renderers
      * Override default renderers or add new ones

package/dist/vue/vue-renderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vue-renderer.d.ts","sourceRoot":"","sources":["../../src/vue/vue-renderer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"vue-renderer.d.ts","sourceRoot":"","sources":["../../src/vue/vue-renderer.ts"],"names":[],"mappings":"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"}

package/dist/vue.js

@@ -1,5 +1,5 @@
-import { D as a, c as d, f as s, g as R, h as n, i as o, j as t, k as c, l, m, n as E, o as i, q as A, s as C, e as D } from "./processor-BOCQYqXE.js";
-import { A as h, c as u, a as T, b as V, n as f, r as g } from "./readonly-record-renderer-CkzY7UvT.js";
+import { D as a, c as d, f as s, g as R, h as n, i as o, j as t, k as c, l, m, n as E, o as i, q as A, s as C, e as D } from "./processor-C_zN3-hL.js";
+import { A as h, c as u, a as T, b as V, n as f, r as g } from "./readonly-record-renderer-G9xOkOFe.js";
 export {
   h as AIMD_RECORD_RENDER_SCOPES,
   a as DEFAULT_AIMD_RENDERER_LOCALE,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@airalogy/aimd-renderer",
   "type": "module",
-  "version": "2.7.0",
+  "version": "2.8.0",
   "description": "AIMD (Airalogy Markdown) rendering engines for HTML and Vue",
   "license": "Apache-2.0",
   "repository": {
@@ -64,7 +64,7 @@
     "shiki": "^2.5.0",
     "unified": "^11.0.5",
     "vfile": "^6.0.3",
-    "@airalogy/aimd-core": "^2.9.0"
+    "@airalogy/aimd-core": "^2.10.0"
   },
   "devDependencies": {
     "@types/node": "^24.3.0",

package/src/__tests__/renderer.test.ts

@@ -1,3 +1,4 @@
+import { existsSync, readFileSync } from 'node:fs'
 import { mount } from '@vue/test-utils'
 import { h } from 'vue'
 import { describe, expect, it, vi } from 'vitest'
@@ -18,6 +19,11 @@ import {
 } from '../vue/readonly-record-renderer'
 import { createCodeBlockRenderer, createStepCardRenderer } from '../vue/vue-renderer'
 
+const rendererStylesPath = existsSync('src/styles/katex.css')
+  ? 'src/styles/katex.css'
+  : 'packages/npm/aimd-renderer/src/styles/katex.css'
+const rendererStyles = readFileSync(rendererStylesPath, 'utf8')
+
 function findVNodeByType(node: any, expectedType: string): any | null {
   if (!node || typeof node !== 'object') {
     return null
@@ -43,6 +49,37 @@ function findVNodeByType(node: any, expectedType: string): any | null {
   return null
 }
 
+function findVNodeByClass(node: any, expectedClass: string): any | null {
+  if (!node || typeof node !== 'object') {
+    return null
+  }
+
+  const className = node.props?.class
+  const classes = Array.isArray(className)
+    ? className
+    : typeof className === 'string'
+      ? className.split(/\s+/)
+      : []
+  if (classes.includes(expectedClass)) {
+    return node
+  }
+
+  const children = Array.isArray(node.children)
+    ? node.children
+    : Array.isArray(node.component?.subTree?.children)
+      ? node.component.subTree.children
+      : []
+
+  for (const child of children) {
+    const match = findVNodeByClass(child, expectedClass)
+    if (match) {
+      return match
+    }
+  }
+
+  return null
+}
+
 function collectVNodeText(node: any): string {
   if (node == null) {
     return ''
@@ -237,6 +274,147 @@ describe('renderToHtmlSync', () => {
     expect(html).toContain('temperature')
   })
 
+  it('resolves figure asset URLs during HTML rendering', () => {
+    const seenContexts: Array<{ src: string, kind: string, id?: string, title?: string }> = []
+    const { html } = renderToHtmlSync([
+      '```fig',
+      'id: workflow_diagram',
+      'src: files/workflow-diagram.svg',
+      'title: Workflow Diagram',
+      '```',
+    ].join('\n'), {
+      resolveAssetUrl: (src, context) => {
+        seenContexts.push({ src, ...context })
+        return `/assets/${src.split('/').pop()}`
+      },
+    })
+
+    expect(seenContexts).toEqual([{
+      src: 'files/workflow-diagram.svg',
+      kind: 'fig',
+      id: 'workflow_diagram',
+      title: 'Workflow Diagram',
+    }])
+    expect(html).toContain('src="/assets/workflow-diagram.svg"')
+  })
+
+  it('renders internal references without route-breaking bare hash hrefs', () => {
+    const { html } = renderToHtmlSync([
+      'As shown in {{ref_fig|workflow_diagram}}, follow {{ref_step|prepare_sample}}.',
+      '',
+      '```fig',
+      'id: workflow_diagram',
+      'src: files/workflow-diagram.svg',
+      'title: Workflow Diagram',
+      '```',
+      '',
+      '{{step|prepare_sample}}',
+    ].join('\n'))
+
+    expect(html).not.toContain('href="#fig-workflow_diagram"')
+    expect(html).not.toContain('href="#step-prepare_sample"')
+    expect(html).toContain('<span class="aimd-ref aimd-ref--fig"')
+    expect(html).toContain('data-aimd-ref-target="workflow_diagram"')
+    expect(html).toContain('data-aimd-ref-kind="fig"')
+    expect(html).toContain('<span class="aimd-ref aimd-ref--step"')
+    expect(html).toContain('data-aimd-ref-target="prepare_sample"')
+    expect(html).toContain('data-aimd-ref-kind="step"')
+  })
+
+  it('styles rendered figures as attached image-caption blocks', () => {
+    expect(rendererStyles).toMatch(/\.aimd-figure \{[\s\S]*?width: fit-content;/)
+    expect(rendererStyles).toMatch(/\.aimd-figure \{[\s\S]*?overflow: hidden;/)
+    expect(rendererStyles).not.toContain('box-shadow: 0 10px 28px')
+    expect(rendererStyles).toMatch(/\.aimd-figure__caption \{[\s\S]*?border-top: 1px solid #d8e2ef;/)
+    expect(rendererStyles).toMatch(/\.aimd-figure__legend \{[\s\S]*?margin: 4px 0 0;/)
+  })
+
+  it('styles citation popovers as selectable hoverable content', () => {
+    expect(rendererStyles).toContain('.aimd-cite__popover')
+    expect(rendererStyles).not.toContain('.aimd-cite__ref::after')
+    expect(rendererStyles).toMatch(/\.aimd-cite__popover \{[\s\S]*?pointer-events: none;/)
+    expect(rendererStyles).toMatch(/\.aimd-cite__popover \{[\s\S]*?user-select: text;/)
+    expect(rendererStyles).toMatch(/\.aimd-cite__popover::before \{[\s\S]*?height: 10px;/)
+    expect(rendererStyles).toMatch(/\.aimd-cite__ref:hover \.aimd-cite__popover,[\s\S]*?pointer-events: auto;/)
+  })
+
+  it('styles internal references as focusable route-safe targets', () => {
+    expect(rendererStyles).toMatch(/\.aimd-ref\[data-aimd-ref-target\] \{[\s\S]*?cursor: pointer;/)
+    expect(rendererStyles).toMatch(/\.aimd-ref\[data-aimd-ref-target\]:focus-visible \{[\s\S]*?outline: 2px solid rgba\(25, 118, 210, 0\.36\);/)
+  })
+
+  it('renders citation markers with reference tooltips and refs blocks', () => {
+    const content = [
+      'Cite the method {{cite|yang2025airalogyaiempowereduniversaldata, doe2024protocol}}.',
+      '',
+      '```refs',
+      '@misc{yang2025airalogyaiempowereduniversaldata,',
+      '      title={Airalogy: AI-empowered universal data digitization for research automation},',
+      '      author={Zijie Yang and Qiji Zhou and Fang Guo and Sijie Zhang and Yexun Xi and Jinglei Nie and Yudian Zhu and Liping Huang and Chou Wu and Yonghe Xia and Xiaoyu Ma and Yingming Pu and Panzhong Lu and Junshu Pan and Mingtao Chen and Tiannan Guo and Yanmei Dou and Hongyu Chen and Anping Zeng and Jiaxing Huang and Tian Xu and Yue Zhang},',
+      '      year={2025},',
+      '      eprint={2506.18586},',
+      '      archivePrefix={arXiv},',
+      '      primaryClass={cs.AI},',
+      '      url={https://arxiv.org/abs/2506.18586},',
+      '}',
+      '',
+      '@misc{doe2024protocol,',
+      '  title = "Protocol Notes",',
+      '  author = "Doe, Jane",',
+      '  year = "2024",',
+      '  url = "https://example.com/protocol"',
+      '}',
+      '```',
+    ].join('\n')
+
+    const { html, fields } = renderToHtmlSync(content)
+
+    expect(fields.cite).toEqual(['yang2025airalogyaiempowereduniversaldata', 'doe2024protocol'])
+    expect(fields.refs?.[0]).toMatchObject({
+      id: 'yang2025airalogyaiempowereduniversaldata',
+      entry_type: 'misc',
+      title: 'Airalogy: AI-empowered universal data digitization for research automation',
+      url: 'https://arxiv.org/abs/2506.18586',
+    })
+    expect(fields.refs?.[1]).toMatchObject({
+      id: 'doe2024protocol',
+      url: 'https://example.com/protocol',
+    })
+    expect(html).not.toContain('href="#ref-yang2025airalogyaiempowereduniversaldata"')
+    expect(html).not.toContain('href="#ref-doe2024protocol"')
+    expect(html).toContain('role="doc-noteref"')
+    expect(html).toContain('data-aimd-ref-id="yang2025airalogyaiempowereduniversaldata"')
+    expect(html).toContain('data-aimd-ref-summary="Zijie Yang')
+    expect(html).toContain('data-aimd-citation-labels="1,2"')
+    expect(html).toContain('<span class="aimd-cite__label">1</span>')
+    expect(html).toContain('<span class="aimd-cite__label">2</span>')
+    expect(html).toContain('<span class="aimd-cite__popover" role="tooltip">Zijie Yang')
+    expect(html).not.toContain('<span class="aimd-cite__label">yang2025airalogyaiempowereduniversaldata</span>')
+    expect(html).toContain('<section class="aimd-refs"')
+    expect(html).toContain('id="ref-yang2025airalogyaiempowereduniversaldata"')
+    expect(html).toContain('Airalogy: AI-empowered universal data digitization for research automation')
+    expect(html).toContain('href="https://arxiv.org/abs/2506.18586"')
+    expect(html).toContain('href="https://example.com/protocol"')
+  })
+
+  it('moves refs blocks to the end of the rendered document', () => {
+    const content = [
+      '```refs',
+      '@misc{doe2024protocol,',
+      '  title = "Protocol Notes",',
+      '  author = "Doe, Jane",',
+      '  year = "2024"',
+      '}',
+      '```',
+      '',
+      'The body continues after the refs declaration.',
+    ].join('\n')
+
+    const { html } = renderToHtmlSync(content)
+
+    expect(html.indexOf('<p>The body continues after the refs declaration.</p>')).toBeLessThan(html.indexOf('<section class="aimd-refs"'))
+  })
+
   it('renders AIMD var field display metadata', () => {
     const { html, fields } = renderToHtmlSync('{{var|record_date: str, title="Record date", description="ISO date", examples=["2026-05-26", "2026-05-27"]}}')
     expect(fields.var_definitions?.[0]?.title).toBe('Record date')
@@ -442,6 +620,120 @@ describe('renderToHtmlSync', () => {
 })
 
 describe('renderToVue', () => {
+  it('renders references as Vue nodes', async () => {
+    const { nodes } = await renderToVue(
+      [
+        'Cite {{cite|yang2025airalogyaiempowereduniversaldata}}.',
+        '',
+        '```refs',
+        '@misc{yang2025airalogyaiempowereduniversaldata,',
+        '      title={Airalogy: AI-empowered universal data digitization for research automation},',
+        '      author={Zijie Yang and Qiji Zhou and Fang Guo and Sijie Zhang and Yexun Xi and Jinglei Nie and Yudian Zhu and Liping Huang and Chou Wu and Yonghe Xia and Xiaoyu Ma and Yingming Pu and Panzhong Lu and Junshu Pan and Mingtao Chen and Tiannan Guo and Yanmei Dou and Hongyu Chen and Anping Zeng and Jiaxing Huang and Tian Xu and Yue Zhang},',
+        '      year={2025},',
+        '      eprint={2506.18586},',
+        '      archivePrefix={arXiv},',
+        '      primaryClass={cs.AI},',
+        '      url={https://arxiv.org/abs/2506.18586},',
+        '}',
+        '```',
+      ].join('\n'),
+    )
+
+    const refsNode = nodes
+      .map(node => findVNodeByType(node, 'section'))
+      .find(Boolean) as any
+    const citeNode = nodes
+      .map(node => findVNodeByClass(node, 'aimd-cite'))
+      .find(Boolean) as any
+
+    expect(refsNode).toBeTruthy()
+    expect(refsNode.props.class).toBe('aimd-refs')
+    expect(refsNode.props.id).toBe('refs')
+    expect(citeNode).toBeTruthy()
+    const citeRefNode = findVNodeByClass(citeNode, 'aimd-cite__ref') as any
+    const citeLabelNode = findVNodeByClass(citeNode, 'aimd-cite__label') as any
+    const citePopoverNode = findVNodeByClass(citeNode, 'aimd-cite__popover') as any
+    expect(citeRefNode.type).toBe('span')
+    expect(citeRefNode.props.href).toBeUndefined()
+    expect(citeRefNode.props['data-aimd-ref-summary']).toContain('Airalogy: AI-empowered universal data digitization for research automation')
+    expect(collectVNodeText(citeLabelNode).trim()).toBe('1')
+    expect(citePopoverNode.type).toBe('span')
+    expect(citePopoverNode.props.role).toBe('tooltip')
+    expect(collectVNodeText(citePopoverNode)).toContain('Airalogy: AI-empowered universal data digitization for research automation')
+    expect(collectVNodeText(nodes)).toContain('References')
+    expect(collectVNodeText(nodes)).toContain('Airalogy: AI-empowered universal data digitization for research automation')
+    expect(collectVNodeText(citeNode)).not.toContain('yang2025airalogyaiempowereduniversaldata')
+  })
+
+  it('resolves figure asset URLs during Vue rendering', async () => {
+    const { nodes } = await renderToVue([
+      '```fig',
+      'id: workflow_diagram',
+      'src: files/workflow-diagram.svg',
+      'title: Workflow Diagram',
+      '```',
+    ].join('\n'), {
+      resolveAssetUrl: (src, context) => {
+        expect(context).toMatchObject({
+          kind: 'fig',
+          id: 'workflow_diagram',
+          title: 'Workflow Diagram',
+        })
+        return `/assets/${src.split('/').pop()}`
+      },
+    })
+
+    const img = findVNodeByType({ children: nodes }, 'img') as any
+    expect(img).toBeTruthy()
+    expect(img.props.src).toBe('/assets/workflow-diagram.svg')
+  })
+
+  it('renders Vue figure references as route-safe internal markers', async () => {
+    const { nodes } = await renderToVue([
+      'As shown in {{ref_fig|workflow_diagram}}.',
+      '',
+      '```fig',
+      'id: workflow_diagram',
+      'src: files/workflow-diagram.svg',
+      'title: Workflow Diagram',
+      '```',
+    ].join('\n'))
+
+    const figRefNode = findVNodeByClass({ children: nodes }, 'aimd-ref--fig') as any
+    expect(figRefNode).toBeTruthy()
+    expect(figRefNode.type).toBe('span')
+    expect(figRefNode.props.href).toBeUndefined()
+    expect(figRefNode.props['data-aimd-ref-target']).toBe('workflow_diagram')
+    expect(figRefNode.props['data-aimd-ref-kind']).toBe('fig')
+    expect(figRefNode.props.tabindex).toBe(0)
+  })
+
+  it('moves refs Vue nodes to the end of the rendered document', async () => {
+    const { nodes } = await renderToVue(
+      [
+        '```refs',
+        '@misc{doe2024protocol,',
+        '  title = "Protocol Notes",',
+        '  author = "Doe, Jane",',
+        '  year = "2024"',
+        '}',
+        '```',
+        '',
+        'The body continues after the refs declaration.',
+      ].join('\n'),
+    )
+
+    const rootChildren = Array.isArray((nodes[0] as any)?.children)
+      ? (nodes[0] as any).children
+      : nodes
+    const refsIndex = rootChildren.findIndex((node: any) => Boolean(findVNodeByClass(node, 'aimd-refs')))
+    const bodyIndex = rootChildren.findIndex((node: any) => collectVNodeText(node).includes('The body continues after the refs declaration.'))
+
+    expect(bodyIndex).toBeGreaterThanOrEqual(0)
+    expect(refsIndex).toBeGreaterThanOrEqual(0)
+    expect(bodyIndex).toBeLessThan(refsIndex)
+  })
+
   it('renders code blocks with line numbers and wrapping classes', async () => {
     const { nodes } = await renderToVue(
       '```json\n{\n  "model":"qwen3.6-flash","enable_search":true\n}\n```',

package/src/common/assetUrls.ts

@@ -0,0 +1,22 @@
+export interface AimdAssetUrlResolveContext {
+  kind: "fig"
+  id?: string
+  title?: string
+}
+
+export type AimdAssetUrlResolver = (
+  src: string,
+  context: AimdAssetUrlResolveContext,
+) => string | null | undefined
+
+export function resolveAimdAssetUrl(
+  src: string | undefined,
+  resolver: AimdAssetUrlResolver | undefined,
+  context: AimdAssetUrlResolveContext,
+): string | undefined {
+  if (!src || !resolver) {
+    return src
+  }
+
+  return resolver(src, context) || src
+}