openmaic-custom/lib/export/inline-assets-importmap.ts
wyuc 86c8e0c543
feat: inline external assets at export for offline classrooms (#596) (#613)
* feat(export): add external-asset reference scanner for HTML inlining

* feat(export): add cached asset fetcher and data-uri encoder

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* feat(export): recursively inline url() refs inside stylesheets

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* feat(export): orchestrate inlining of links, scripts, images, and inline css

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* refactor(export): drop dead escapeAttr, harden importmap skip in scanner

* feat(export): inline importmap modules incl three/addons graph closure

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* refactor(export): extract shared module to break inline-assets import cycle

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* feat(export): inline interactive-scene assets into .maic.zip at export

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* feat(export): inline interactive assets in Resource Pack export too

* docs: document offline export asset inlining

* style: prettier formatting

* fix(test): resolve tsc type errors in export-classroom-inline test

* fix(export): keep importmap prefix fallback on partial failure, chunk base64, preserve media attr, log pptx inline failures

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* perf(export): parallelize asset fetching, share fetcher across scenes, promise-cache

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* fix(export): retry transient asset fetches, bound concurrency, warn user on partial inline

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* perf(export): inline only woff2 fonts, drop woff/ttf siblings to halve size

Within @font-face blocks that have a woff2 url(), rewrite sibling woff/ttf/otf/eot
refs to url(about:invalid) instead of inlining them. Falls back to full inline for
ttf-only blocks. Drops katex output from ~1.79MB to ~0.71MB (~3x fewer font fetches).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* i18n(export): translate partial-inline warning and surface failed asset hosts

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* feat(proxy-media): follow redirects with per-hop SSRF revalidation (#398)

Replace blanket redirect rejection with a bounded 5-hop follow loop that
re-validates every Location target through validateUrlForSSRF before
fetching, preventing redirect-to-internal SSRF while allowing CDN
redirects (e.g. cdn.tailwindcss.com 302→/3.4.17).

* feat(export): route asset inlining through proxy-media to bypass CORS

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* fix(export): keep importmap prefix fallback, forward proxy 4xx, cap proxy size, re-export FetchAsset

* style: prettier formatting for proxy-media + proxied-fetch

* fix(export): report CSS-nested asset failures in inline report

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-authored-by: 杨慎 <117187635+cosarah@users.noreply.github.com>
2026-05-31 18:36:39 +08:00

68 lines
2.6 KiB
TypeScript

import { toDataUri, type InlineReport } from './inline-assets-shared';
// Matches: import ... from 'X' | import 'X' | export ... from 'X' | import('X')
const IMPORT_SPEC_RE =
/(?:\bimport\b[\s\S]*?\bfrom\b|\bexport\b[\s\S]*?\bfrom\b|\bimport)\s*["']([^"']+)["']|\bimport\(\s*["']([^"']+)["']\s*\)/g;
export function extractSpecifiers(code: string): string[] {
const specs = new Set<string>();
for (const m of code.matchAll(IMPORT_SPEC_RE)) {
const s = m[1] ?? m[2];
if (s) specs.add(s);
}
return [...specs];
}
/** Resolve a specifier against importmap: exact match first, then longest '/'-terminated prefix. */
export function resolveSpecifier(spec: string, imports: Record<string, string>): string | null {
if (spec in imports) return imports[spec];
let best: { key: string; url: string } | null = null;
for (const [key, url] of Object.entries(imports)) {
if (key.endsWith('/') && spec.startsWith(key)) {
if (!best || key.length > best.key.length) best = { key, url };
}
}
return best ? best.url + spec.slice(best.key.length) : null;
}
export async function buildInlinedImportmap(
originalImports: Record<string, string>,
moduleScriptBodies: string[],
fetchAsset: (url: string) => Promise<{ bytes: Uint8Array; contentType: string } | null>,
): Promise<{ imports: Record<string, string>; report: InlineReport }> {
const report: InlineReport = { inlined: [], failed: [] };
const resolvedDataUri = new Map<string, string>(); // specifier -> data: URI
const visited = new Set<string>();
async function visitSpecifier(spec: string): Promise<void> {
if (visited.has(spec)) return;
visited.add(spec);
const absUrl = resolveSpecifier(spec, originalImports);
if (!absUrl) return; // not mapped (relative/bare-unmapped) — leave to browser
if (/^data:/i.test(absUrl)) {
resolvedDataUri.set(spec, absUrl);
return;
}
const got = await fetchAsset(absUrl);
if (!got) {
if (!report.failed.some((f) => f.url === absUrl))
report.failed.push({ url: absUrl, reason: 'fetch failed' });
return;
}
resolvedDataUri.set(spec, toDataUri(got.bytes, got.contentType));
if (!report.inlined.includes(absUrl)) report.inlined.push(absUrl);
const code = new TextDecoder().decode(got.bytes);
for (const childSpec of extractSpecifiers(code)) {
await visitSpecifier(childSpec);
}
}
for (const body of moduleScriptBodies) {
for (const spec of extractSpecifiers(body)) await visitSpecifier(spec);
}
const imports: Record<string, string> = {};
for (const [spec, dataUri] of resolvedDataUri) imports[spec] = dataUri;
return { imports, report };
}