webgal-parser 4.6.1 → 4.6.3-beta.1

package/build/es/interface/runtimeInterface.d.ts

@@ -6,6 +6,8 @@ export interface sceneEntry {
     sceneName: string;
     sceneUrl: string;
     continueLine: number;
+    locals?: Record<string, any>;
+    writeReturnTo?: string;
 }
 /**
  * 场景栈条目接口 (兼容性别名)

package/build/es/interface/sceneInterface.d.ts

@@ -38,7 +38,8 @@ export declare enum commandType {
     getUserInput = 31,
     applyStyle = 32,
     wait = 33,
-    callSteam = 34
+    callSteam = 34,
+    return = 35
 }
 /**
  * 单个参数接口
@@ -70,6 +71,15 @@ export interface ISentence {
     sentenceAssets: Array<IAsset>;
     subScene: Array<string>;
     inlineComment: string;
+    /**
+     * 本语句在原始场景文件中占据的行范围（0-based，含首尾）。
+     * 单行语句 startLine === endLine；多行语句 endLine 指向最后一条续行。
+     * 图形编辑器据此做「只替换被编辑语句所占的行」。
+     */
+    startLine: number;
+    endLine: number;
+    /** 本条是多行语句被折叠掉的续行占位，仅用于补齐行数，不应展示给用户 */
+    isLineBreakHolder: boolean;
 }
 /**
  * 场景接口

package/build/es/sceneTextPreProcessor.d.ts

@@ -9,3 +9,13 @@
  * @returns The processed scene text
  */
 export declare function sceneTextPreProcess(sceneText: string): string;
+/**
+ * 占位行的前缀。占位行本身是一条注释，引擎会空跑掉；
+ * 它的作用是让预处理后的行数与原始场景一致，从而保持
+ * 「解析后语句 index == 文件行号」这一不变量。
+ */
+export declare const WEBGAL_LINE_BREAK_MARK = ";_WEBGAL_LINE_BREAK_";
+/**
+ * 判断预处理后的某一行是否是占位行，即它是上一条多行语句折叠掉的续行。
+ */
+export declare function isLineBreakPlaceholder(processedLine: string): boolean;

package/build/types/index.d.ts

@@ -3,7 +3,7 @@ import { WebgalConfig } from './configParser/configParser';
 import { fileType } from './interface/assets';
 import { IAsset } from './interface/sceneInterface';
 import { IWebGALStyleObj } from "./styleParser";
-import { sceneTextPreProcess } from "./sceneTextPreProcessor";
+import { isLineBreakPlaceholder, sceneTextPreProcess, WEBGAL_LINE_BREAK_MARK } from "./sceneTextPreProcessor";
 export default class SceneParser {
     private readonly assetsPrefetcher;
     private readonly assetSetter;
@@ -23,4 +23,4 @@ export default class SceneParser {
     parseScssToWebgalStyleObj(scssString: string): IWebGALStyleObj;
 }
 export { ADD_NEXT_ARG_LIST, SCRIPT_CONFIG };
-export { sceneTextPreProcess };
+export { sceneTextPreProcess, isLineBreakPlaceholder, WEBGAL_LINE_BREAK_MARK };

package/build/types/interface/runtimeInterface.d.ts

@@ -6,6 +6,8 @@ export interface sceneEntry {
     sceneName: string;
     sceneUrl: string;
     continueLine: number;
+    locals?: Record<string, any>;
+    writeReturnTo?: string;
 }
 /**
  * 场景栈条目接口 (兼容性别名)

package/build/types/interface/sceneInterface.d.ts

@@ -38,7 +38,8 @@ export declare enum commandType {
     getUserInput = 31,
     applyStyle = 32,
     wait = 33,
-    callSteam = 34
+    callSteam = 34,
+    return = 35
 }
 /**
  * 单个参数接口
@@ -70,6 +71,15 @@ export interface ISentence {
     sentenceAssets: Array<IAsset>;
     subScene: Array<string>;
     inlineComment: string;
+    /**
+     * 本语句在原始场景文件中占据的行范围（0-based，含首尾）。
+     * 单行语句 startLine === endLine；多行语句 endLine 指向最后一条续行。
+     * 图形编辑器据此做「只替换被编辑语句所占的行」。
+     */
+    startLine: number;
+    endLine: number;
+    /** 本条是多行语句被折叠掉的续行占位，仅用于补齐行数，不应展示给用户 */
+    isLineBreakHolder: boolean;
 }
 /**
  * 场景接口

package/build/types/sceneTextPreProcessor.d.ts

@@ -9,3 +9,13 @@
  * @returns The processed scene text
  */
 export declare function sceneTextPreProcess(sceneText: string): string;
+/**
+ * 占位行的前缀。占位行本身是一条注释，引擎会空跑掉；
+ * 它的作用是让预处理后的行数与原始场景一致，从而保持
+ * 「解析后语句 index == 文件行号」这一不变量。
+ */
+export declare const WEBGAL_LINE_BREAK_MARK = ";_WEBGAL_LINE_BREAK_";
+/**
+ * 判断预处理后的某一行是否是占位行，即它是上一条多行语句折叠掉的续行。
+ */
+export declare function isLineBreakPlaceholder(processedLine: string): boolean;