@forge-kit/plugin-source-map-prase 0.0.1 → 0.0.3

package/src/shared/trace-common.ts

@@ -0,0 +1,104 @@
+export const DEFAULT_CONTEXT_LINE_RADIUS = 3
+
+export interface TraceLocation {
+    fileName: string
+    lineNumber: number
+    columnNumber: number
+}
+
+export interface ResolvedSourceMeta {
+    sourceFile: string
+    lineNumber: number
+    columnNumber: number
+}
+
+export interface TraceSnippetState {
+    traceCode: string
+    resolvedSourceMeta: ResolvedSourceMeta | null
+    traceHighlightLines: number[]
+}
+
+export interface TraceMetaOutputState<TTraceHop = unknown> {
+    traceData: TTraceHop[]
+    resolvedSourceMeta: ResolvedSourceMeta | null
+    canFetchSourceSnippet: boolean
+    message: string
+}
+
+export interface ResolveInputConfig {
+    entryFileName: string
+    entryLine: string
+    entryColumn: string
+    contextLineRadius: string
+    mapCount: number
+}
+
+export type ResolveInputValidation =
+    | { ok: true; entry: TraceLocation; contextLineRadius: number }
+    | { ok: false; message: string }
+
+export interface TraceOutputState<TTraceHop = unknown> {
+    traceData: TTraceHop[]
+    traceCode: string
+    resolvedSourceMeta: ResolvedSourceMeta | null
+    traceHighlightLines: number[]
+}
+
+export const createInitialOutputState = <TTraceHop = unknown>(): TraceOutputState<TTraceHop> => {
+    return {
+        traceData: [],
+        traceCode: "请先上传一个或多个 .map 文件。",
+        resolvedSourceMeta: null,
+        traceHighlightLines: [],
+    }
+}
+
+export const patchOutputMessage = <TTraceHop = unknown>(
+    prev: TraceOutputState<TTraceHop>,
+    message: string,
+): TraceOutputState<TTraceHop> => {
+    return {
+        ...prev,
+        traceCode: message,
+        traceHighlightLines: [],
+    }
+}
+
+export const 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,
+    }
+}

package/src/shared/trace-contract.ts

@@ -0,0 +1,29 @@
+import type {ResolvedSourceMeta, TraceLocation} from "@/shared/trace-common";
+
+export interface ResolveTraceInput {
+    entryFileName: string
+    entryLine: string
+    entryColumn: string
+    contextLineRadius?: string
+    mapFilePaths: string[]
+    maxSnippetPayloadBytes?: string
+}
+
+export interface TraceHopPayload {
+    input: TraceLocation
+    output?: TraceLocation
+    mapFileName?: string
+}
+
+export interface ResolveTraceMetaOutput {
+    traceData: TraceHopPayload[]
+    resolvedSourceMeta: ResolvedSourceMeta | null
+    canFetchSourceSnippet: boolean
+    message: string
+}
+
+export interface ResolveTraceSnippetOutput {
+    traceCode: string
+    resolvedSourceMeta: ResolvedSourceMeta | null
+    traceHighlightLines: number[]
+}

package/src/types.ts

@@ -0,0 +1,19 @@
+export type {
+    ResolveTraceInput,
+    ResolveTraceMetaOutput,
+    ResolveTraceSnippetOutput,
+} from "@/shared/trace-contract";
+
+export interface MapInputConfig {
+    entryLine: string
+    entryColumn: string
+    contextLineRadius: string
+}
+
+export interface ForgeKitBridge {
+    applyNodeMethod?: (method: string, ...args: string[]) => Promise<unknown>
+    openFileDialog?: (options: {
+        multiple?: boolean
+        filters?: {name: string; extensions: string[]}[]
+    }) => Promise<string | string[] | null>
+}

package/src/utils/trace-ui/index.ts

@@ -0,0 +1,12 @@
+export {SourceMapUtils} from "./state"
+
+export type {
+    TraceOutputState,
+    SourceMapChainState,
+    TraceDisplayHop,
+    ResolveInputConfig,
+    ChainMapSlot,
+    TraceLocation,
+    TraceHop,
+    ResolvedSourceMeta,
+} from "./state"

package/src/utils/trace-ui/state.ts

@@ -0,0 +1,81 @@
+import {
+    DEFAULT_CONTEXT_LINE_RADIUS,
+    createInitialOutputState,
+    patchOutputMessage,
+    validateResolveInput,
+} from "@/shared/trace-common";
+import type {
+    ResolveInputConfig,
+    ResolveInputValidation,
+    TraceLocation,
+    TraceOutputState as SharedTraceOutputState,
+} from "@/shared/trace-common";
+export type {ResolveInputConfig, ResolvedSourceMeta, TraceLocation} from "@/shared/trace-common";
+
+export interface TraceHop {
+    input: TraceLocation
+    output?: TraceLocation
+    mapFileName?: string
+}
+
+export type TraceOutputState = SharedTraceOutputState<TraceHop>
+
+export interface SourceMapChainState {
+    chainMapSlots: ChainMapSlot[]
+    entryFileName: string
+}
+
+export interface ChainMapSlot {
+    id: string
+    mapFileName: string
+    mapFilePath?: string
+    error?: string
+}
+
+export interface TraceDisplayHop {
+    input: TraceLocation
+    output?: TraceLocation
+    mapFileName?: string
+}
+
+export class SourceMapUtils {
+    static readonly DEFAULT_CONTEXT_LINE_RADIUS = DEFAULT_CONTEXT_LINE_RADIUS
+
+    static createInitialOutputState(): TraceOutputState {
+        return createInitialOutputState<TraceHop>()
+    }
+
+    static patchOutputMessage(prev: TraceOutputState, message: string): TraceOutputState {
+        return patchOutputMessage(prev, message)
+    }
+
+    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 = {...item.output}
+            return {
+                input: {...item.input},
+                output,
+                mapFileName: item.mapFileName,
+            }
+        })
+    }
+
+    static validateResolveInput(config: ResolveInputConfig): ResolveInputValidation {
+        return validateResolveInput(config)
+    }
+
+}

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,
-    }
-}