@forge-kit/plugin-source-map-prase 0.0.2 → 0.0.4

package/src/utils/source-map/domain/chain-slots.ts

@@ -1,59 +0,0 @@
-import {normalizePath, stripMapExt} from "../base/path";
-import {registerSourceMap} from "../base/registry";
-import type {ChainMapSlot, SourceMapRegistry} from "../base/types";
-
-export const createChainSlotFromFile = async (file: File): Promise<ChainMapSlot> => {
-    const slotId = `${file.name}-${Math.random().toString(36).slice(2, 8)}`
-
-    try {
-        const fileText = await file.text()
-        const rawSourceMap = JSON.parse(fileText)
-
-        if (!rawSourceMap || typeof rawSourceMap !== "object" || typeof rawSourceMap.mappings !== "string") {
-            throw new Error("invalid source-map json")
-        }
-
-        return {
-            id: slotId,
-            mapFileName: file.name,
-            sourceMapRecord: {rawSourceMap, mapFileName: file.name},
-        }
-    } catch (error) {
-        const message = error instanceof Error ? error.message : "unknown error"
-        return {
-            id: slotId,
-            mapFileName: file.name,
-            error: `${file.name}: ${message}`,
-        }
-    }
-}
-
-export const buildRegistryFromChainSlots = (slots: ChainMapSlot[]) => {
-    let registry: SourceMapRegistry = {}
-    const orderedMapFileNames: string[] = []
-
-    slots.forEach((slot) => {
-        const {sourceMapRecord: record} = slot
-        if (!record) return
-
-        orderedMapFileNames.push(record.mapFileName)
-        registry = registerSourceMap(registry, record.mapFileName, record)
-        registry = registerSourceMap(registry, stripMapExt(record.mapFileName), record)
-
-        if (record.rawSourceMap.file) {
-            registry = registerSourceMap(registry, record.rawSourceMap.file, record)
-        }
-    })
-
-    return {registry, orderedMapFileNames}
-}
-
-export const getAutoEntryFileNameFromSlots = (slots: ChainMapSlot[]) => {
-    const firstValidSlot = slots.find((slot) => slot.sourceMapRecord)
-    if (!firstValidSlot?.sourceMapRecord) return ""
-
-    const mappedFile = firstValidSlot.sourceMapRecord.rawSourceMap.file
-    if (mappedFile) return normalizePath(mappedFile)
-
-    return stripMapExt(firstValidSlot.sourceMapRecord.mapFileName)
-}

package/src/utils/source-map/domain/trace-resolver.ts

@@ -1,165 +0,0 @@
-import {SourceMapConsumer, type RawSourceMap} from "source-map-js";
-import {MAX_TRACE_DEPTH} from "../base/constants";
-import {getSourceMapByFileName, getSourceMapByMapFileName} from "../base/registry";
-import type {ResolveTraceOptions, SourceMapRecord, SourceMapRegistry, TraceHop, TraceLocation} from "../base/types";
-
-interface ResolvedTraceHop extends TraceHop {
-    output: TraceLocation
-}
-
-const toLocationCursor = (location: TraceLocation) => {
-    return `${location.fileName}:${location.lineNumber}:${location.columnNumber}`
-}
-
-const isSameLocation = (left: TraceLocation, right: TraceLocation) => {
-    return (
-        left.fileName === right.fileName
-        && left.lineNumber === right.lineNumber
-        && left.columnNumber === right.columnNumber
-    )
-}
-
-const resolveOriginalLocation = (
-    rawSourceMap: RawSourceMap,
-    position: { line: number; column: number },
-): TraceLocation | null => {
-    const consumer = new SourceMapConsumer(rawSourceMap)
-
-    const attempts = [
-        {line: position.line, column: position.column, bias: SourceMapConsumer.GREATEST_LOWER_BOUND},
-        {line: position.line, column: 0, bias: SourceMapConsumer.GREATEST_LOWER_BOUND},
-        {line: position.line, column: position.column, bias: SourceMapConsumer.LEAST_UPPER_BOUND},
-        {line: position.line, column: 0, bias: SourceMapConsumer.LEAST_UPPER_BOUND},
-    ]
-
-    for (const attempt of attempts) {
-        const found = consumer.originalPositionFor(attempt)
-        if (found.source && found.line != null && found.column != null) {
-            return {
-                fileName: found.source,
-                lineNumber: found.line,
-                columnNumber: found.column,
-            }
-        }
-    }
-
-    return null
-}
-
-const resolveHopFromRecord = (sourceMapRecord: SourceMapRecord, input: TraceLocation): ResolvedTraceHop | null => {
-    try {
-        const output = resolveOriginalLocation(sourceMapRecord.rawSourceMap, {
-            line: input.lineNumber,
-            column: input.columnNumber,
-        })
-        if (!output) return null
-
-        return {
-            input,
-            output,
-            mapFileName: sourceMapRecord.mapFileName,
-        }
-    } catch {
-        return null
-    }
-}
-
-const appendUnresolvedHop = (traceHops: TraceHop[], input: TraceLocation, mapFileName?: string) => {
-    traceHops.push({input, mapFileName})
-}
-
-const resolveTraceWithOrderedMaps = (
-    entry: TraceLocation,
-    sourceMaps: SourceMapRegistry,
-    orderedMapFileNames: string[],
-    maxDepth: number,
-) => {
-    const traceHops: TraceHop[] = []
-    const visited = new Set<string>()
-    let current = entry
-
-    for (let depth = 0; depth < orderedMapFileNames.length && depth < maxDepth; depth++) {
-        const mapFileName = orderedMapFileNames[depth]
-        const cursor = toLocationCursor(current)
-
-        if (visited.has(cursor)) {
-            appendUnresolvedHop(traceHops, current, mapFileName)
-            continue
-        }
-        visited.add(cursor)
-
-        const sourceMapRecord = getSourceMapByMapFileName(sourceMaps, mapFileName)
-        if (!sourceMapRecord) {
-            appendUnresolvedHop(traceHops, current, mapFileName)
-            continue
-        }
-
-        const hop = resolveHopFromRecord(sourceMapRecord, current)
-        if (!hop) {
-            appendUnresolvedHop(traceHops, current, sourceMapRecord.mapFileName)
-            continue
-        }
-
-        traceHops.push(hop)
-        current = hop.output
-    }
-
-    return traceHops
-}
-
-const resolveTraceByFileLookup = (
-    entry: TraceLocation,
-    sourceMaps: SourceMapRegistry,
-    maxDepth: number,
-) => {
-    const traceHops: TraceHop[] = []
-    const visited = new Set<string>()
-    let current = entry
-
-    for (let depth = 0; depth < maxDepth; depth++) {
-        const cursor = toLocationCursor(current)
-
-        if (visited.has(cursor)) {
-            appendUnresolvedHop(traceHops, current)
-            break
-        }
-        visited.add(cursor)
-
-        const sourceMapRecord = getSourceMapByFileName(sourceMaps, current.fileName)
-        if (!sourceMapRecord) {
-            if (traceHops.length === 0) {
-                appendUnresolvedHop(traceHops, current)
-            }
-            break
-        }
-
-        const hop = resolveHopFromRecord(sourceMapRecord, current)
-        if (!hop) {
-            appendUnresolvedHop(traceHops, current, sourceMapRecord.mapFileName)
-            break
-        }
-
-        traceHops.push(hop)
-        if (isSameLocation(hop.output, current)) {
-            break
-        }
-        current = hop.output
-    }
-
-    return traceHops
-}
-
-export const resolveTraceBySourceMaps = async (
-    entry: TraceLocation,
-    sourceMaps: SourceMapRegistry,
-    orderedMapFileNames: string[] = [],
-    options: ResolveTraceOptions = {},
-): Promise<TraceHop[]> => {
-    const maxDepth = options.maxDepth ?? MAX_TRACE_DEPTH
-
-    if (orderedMapFileNames.length > 0) {
-        return resolveTraceWithOrderedMaps(entry, sourceMaps, orderedMapFileNames, maxDepth)
-    }
-
-    return resolveTraceByFileLookup(entry, sourceMaps, maxDepth)
-}

package/src/utils/source-map/domain/view-model.ts

@@ -1,20 +0,0 @@
-import {DEFAULT_CONTEXT_LINE_RADIUS} from "../base/constants";
-import type {TraceLocation} from "../base/types";
-
-export const toDisplayLocation = (location: TraceLocation): TraceLocation => ({...location})
-
-export const createCodeExcerpt = (fullCode: string, targetLine: number, radius = DEFAULT_CONTEXT_LINE_RADIUS) => {
-    const lines = fullCode.split(/\r?\n/)
-    if (lines.length === 0) {
-        return {code: fullCode, highlightLine: targetLine}
-    }
-
-    const safeTarget = Math.min(Math.max(targetLine, 1), lines.length)
-    const start = Math.max(1, safeTarget - radius)
-    const end = Math.min(lines.length, safeTarget + radius)
-
-    return {
-        code: lines.slice(start - 1, end).join("\n"),
-        highlightLine: safeTarget - start + 1,
-    }
-}

package/src/utils/source-map/facade/source-map-utils.ts

@@ -1,212 +0,0 @@
-import {DEFAULT_CONTEXT_LINE_RADIUS, MAX_TRACE_DEPTH} from "../base/constants";
-import {createChainSlotFromFile, buildRegistryFromChainSlots, getAutoEntryFileNameFromSlots} from "../domain/chain-slots";
-import {resolveSourceCodeFromTrace, getLastResolvedOutput} from "../domain/source-content";
-import {resolveTraceBySourceMaps} from "../domain/trace-resolver";
-import {toDisplayLocation, createCodeExcerpt} from "../domain/view-model";
-import type {
-    ChainMapSlot,
-    ResolvedSourceMeta,
-    SourceMapRegistry,
-    TraceHop,
-    TraceLocation,
-} from "../base/types";
-
-export interface TraceOutputState {
-    traceData: TraceHop[]
-    traceCode: string
-    resolvedSourceMeta: ResolvedSourceMeta | null
-    traceHighlightLines: number[]
-}
-
-export interface SourceMapChainState {
-    sourceMaps: SourceMapRegistry
-    sourceMapFileNames: string[]
-    chainMapSlots: ChainMapSlot[]
-    entryFileName: string
-}
-
-export interface TraceDisplayHop {
-    input: TraceLocation
-    output?: TraceLocation
-    mapFileName?: string
-}
-
-export interface ResolveInputConfig {
-    entryFileName: string
-    entryLine: string
-    entryColumn: string
-    contextLineRadius: string
-    mapCount: number
-}
-
-interface ResolveTaskContext {
-    entry: TraceLocation
-    contextLineRadius: number
-    sourceMaps: SourceMapRegistry
-    sourceMapFileNames: string[]
-}
-
-type ResolveInputValidation =
-    | { ok: true; entry: TraceLocation; contextLineRadius: number }
-    | { ok: false; message: string }
-
-export class SourceMapUtils {
-    static readonly MAX_TRACE_DEPTH = MAX_TRACE_DEPTH
-    static readonly DEFAULT_CONTEXT_LINE_RADIUS = DEFAULT_CONTEXT_LINE_RADIUS
-
-    static createInitialOutputState(): TraceOutputState {
-        return {
-            traceData: [],
-            traceCode: "请先上传一个或多个 .map 文件。",
-            resolvedSourceMeta: null,
-            traceHighlightLines: [],
-        }
-    }
-
-    static patchOutputMessage(prev: TraceOutputState, message: string): TraceOutputState {
-        return {
-            ...prev,
-            traceCode: message,
-            traceHighlightLines: [],
-        }
-    }
-
-    static createChainSlotFromFile(file: File): Promise<ChainMapSlot> {
-        return createChainSlotFromFile(file)
-    }
-
-    static buildChainStateFromSlots(slots: ChainMapSlot[]): SourceMapChainState {
-        const {registry, orderedMapFileNames} = buildRegistryFromChainSlots(slots)
-        return {
-            sourceMaps: registry,
-            sourceMapFileNames: orderedMapFileNames,
-            chainMapSlots: slots,
-            entryFileName: getAutoEntryFileNameFromSlots(slots),
-        }
-    }
-
-    static removeChainSlot(slots: ChainMapSlot[], slotId: string): ChainMapSlot[] {
-        return slots.filter((item) => item.id !== slotId)
-    }
-
-    static reorderChainSlots(slots: ChainMapSlot[], nextIds: string[]): ChainMapSlot[] {
-        const idOrder = new Map(nextIds.map((id, index) => [id, index]))
-        return [...slots].sort((a, b) => {
-            const aIndex = idOrder.get(a.id) ?? Number.MAX_SAFE_INTEGER
-            const bIndex = idOrder.get(b.id) ?? Number.MAX_SAFE_INTEGER
-            return aIndex - bIndex
-        })
-    }
-
-    static mapTraceForDisplay(traceData: TraceHop[]): TraceDisplayHop[] {
-        return traceData.map((item) => {
-            let output: TraceLocation | undefined
-            if (item.output) {
-                output = toDisplayLocation(item.output)
-            }
-            return {
-                input: toDisplayLocation(item.input),
-                output,
-                mapFileName: item.mapFileName,
-            }
-        })
-    }
-
-    static validateResolveInput(config: ResolveInputConfig): ResolveInputValidation {
-        const parsedLine = Number(config.entryLine)
-        const parsedColumn = Number(config.entryColumn)
-        const parsedContextLineRadius = Number(config.contextLineRadius)
-        const normalizedFileName = config.entryFileName.replace(/\\/g, "/").trim()
-
-        if (!normalizedFileName) {
-            return {ok: false, message: "请输入入口文件名，例如 index.js"}
-        }
-        if (!config.entryLine.trim()) {
-            return {ok: false, message: "请输入入口行号（1-based）。"}
-        }
-        if (!config.entryColumn.trim()) {
-            return {ok: false, message: "请输入入口列号（0-based）。"}
-        }
-        if (!Number.isInteger(parsedLine) || parsedLine < 1) {
-            return {ok: false, message: "行号必须是大于等于 1 的整数。"}
-        }
-        if (!Number.isInteger(parsedColumn) || parsedColumn < 0) {
-            return {ok: false, message: "列号必须是大于等于 0 的整数。"}
-        }
-        if (!Number.isInteger(parsedContextLineRadius) || parsedContextLineRadius < 0) {
-            return {ok: false, message: "上下文行数必须是大于等于 0 的整数。"}
-        }
-        if (config.mapCount === 0) {
-            return {ok: false, message: "未加载可用 map 文件，请先上传。"}
-        }
-
-        return {
-            ok: true,
-            entry: {
-                fileName: normalizedFileName,
-                lineNumber: parsedLine,
-                columnNumber: parsedColumn,
-            },
-            contextLineRadius: parsedContextLineRadius,
-        }
-    }
-
-    static async resolveTraceOutput(context: ResolveTaskContext): Promise<TraceOutputState> {
-        try {
-            const traceChain = await resolveTraceBySourceMaps(
-                context.entry,
-                context.sourceMaps,
-                context.sourceMapFileNames,
-                {maxDepth: this.MAX_TRACE_DEPTH},
-            )
-
-            const sourceCode = resolveSourceCodeFromTrace(traceChain, context.sourceMaps)
-            if (sourceCode) {
-                const excerpt = createCodeExcerpt(sourceCode.code, sourceCode.lineNumber, context.contextLineRadius)
-                return {
-                    traceData: traceChain,
-                    traceCode: excerpt.code,
-                    resolvedSourceMeta: {
-                        sourceFile: sourceCode.sourceFile,
-                        lineNumber: sourceCode.lineNumber,
-                        columnNumber: sourceCode.columnNumber,
-                    },
-                    traceHighlightLines: [excerpt.highlightLine],
-                }
-            }
-
-            const lastResolved = getLastResolvedOutput(traceChain)
-            if (lastResolved) {
-                const display = toDisplayLocation(lastResolved)
-                return {
-                    traceData: traceChain,
-                    traceCode: [
-                        `已定位到源码位置：${display.fileName}:${display.lineNumber}:${display.columnNumber}`,
-                        "当前 map 不包含 sourcesContent，无法直接渲染源码内容。",
-                    ].join("\n"),
-                    resolvedSourceMeta: {
-                        sourceFile: display.fileName,
-                        lineNumber: display.lineNumber,
-                        columnNumber: display.columnNumber,
-                    },
-                    traceHighlightLines: [],
-                }
-            }
-
-            return {
-                traceData: traceChain,
-                traceCode: "未命中映射，未定位到源码位置。",
-                resolvedSourceMeta: null,
-                traceHighlightLines: [],
-            }
-        } catch (error) {
-            const message = error instanceof Error ? error.message : "unknown error"
-            return {
-                traceData: [{input: context.entry}],
-                traceCode: `source-map trace failed: ${message}`,
-                resolvedSourceMeta: null,
-                traceHighlightLines: [],
-            }
-        }
-    }
-}

package/src/utils/source-map/index.ts

@@ -1,18 +0,0 @@
-export {SourceMapUtils} from "./facade/source-map-utils"
-
-export type {
-    TraceOutputState,
-    SourceMapChainState,
-    TraceDisplayHop,
-    ResolveInputConfig,
-} from "./facade/source-map-utils"
-
-export type {
-    ChainMapSlot,
-    SourceMapRegistry,
-    TraceLocation,
-    TraceHop,
-    ResolvedSourceMeta,
-    ResolveTraceOptions,
-    SourceMapRecord,
-} from "./base/types"