@liminalia/runtime 0.0.0-stage → 0.8.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +106 -0
- package/dist/src/chat.js +60 -0
- package/dist/src/commands-play.js +300 -0
- package/dist/src/commands.js +534 -0
- package/dist/src/coverage.js +208 -0
- package/dist/src/headless.js +109 -0
- package/dist/src/host.js +1 -0
- package/dist/src/index.js +15 -0
- package/dist/src/prefetch.js +80 -0
- package/dist/src/program.js +131 -0
- package/dist/src/project-options.js +84 -0
- package/dist/src/retranslate.js +44 -0
- package/dist/src/route.js +242 -0
- package/dist/src/runtime.js +1929 -0
- package/dist/src/save.js +51 -0
- package/dist/src/scenario-test.js +200 -0
- package/dist/src/state.js +62 -0
- package/dist/src/value.js +464 -0
- package/dist/src/voice-observe.js +82 -0
- package/package.json +33 -4
- package/src/chat.ts +109 -0
- package/src/commands-play.ts +280 -0
- package/src/commands.ts +457 -0
- package/src/coverage.ts +257 -0
- package/src/headless.ts +139 -0
- package/src/host.ts +116 -0
- package/src/index.ts +16 -0
- package/src/prefetch.ts +78 -0
- package/src/program.ts +186 -0
- package/src/project-options.ts +128 -0
- package/src/retranslate.ts +67 -0
- package/src/route.ts +365 -0
- package/src/runtime.ts +2143 -0
- package/src/save.ts +60 -0
- package/src/scenario-test.ts +218 -0
- package/src/state.ts +353 -0
- package/src/value.ts +443 -0
- package/src/voice-observe.ts +85 -0
- package/types/src/chat.d.ts +63 -0
- package/types/src/commands-play.d.ts +2 -0
- package/types/src/commands.d.ts +2 -0
- package/types/src/coverage.d.ts +100 -0
- package/types/src/headless.d.ts +77 -0
- package/types/src/host.d.ts +140 -0
- package/types/src/index.d.ts +16 -0
- package/types/src/prefetch.d.ts +18 -0
- package/types/src/program.d.ts +107 -0
- package/types/src/project-options.d.ts +103 -0
- package/types/src/retranslate.d.ts +39 -0
- package/types/src/route.d.ts +181 -0
- package/types/src/runtime.d.ts +553 -0
- package/types/src/save.d.ts +21 -0
- package/types/src/scenario-test.d.ts +43 -0
- package/types/src/state.d.ts +357 -0
- package/types/src/value.d.ts +61 -0
- package/types/src/voice-observe.d.ts +26 -0
- package/README.md +0 -3
|
@@ -0,0 +1,357 @@
|
|
|
1
|
+
import type { TextStyle } from "./host.js";
|
|
2
|
+
import type { TextOrigin } from "./retranslate.js";
|
|
3
|
+
import type { Scope, Value } from "./value.js";
|
|
4
|
+
export { voiceFile } from "@liminalia/lang";
|
|
5
|
+
export interface Position {
|
|
6
|
+
/** Unit の id("chapter1" や "chapter1::title-card")。 */
|
|
7
|
+
unit: string;
|
|
8
|
+
/** 次に実行する命令の位置。 */
|
|
9
|
+
index: number;
|
|
10
|
+
/**
|
|
11
|
+
* セーブした場所の目印(本文・選択肢の行と、その文から作る鍵)。作品を更新して台本の行がずれても、
|
|
12
|
+
* ロードで同じページを探して再開する(Runtime.load)。セーブのときだけ付ける。
|
|
13
|
+
*/
|
|
14
|
+
anchor?: {
|
|
15
|
+
line: number;
|
|
16
|
+
key: string;
|
|
17
|
+
/** 呼び出しの戻り先の目印のとき、目印は戻り先の一つ前の命令(呼んだ命令。鍵は命令の名前と引数)。 */
|
|
18
|
+
after?: boolean;
|
|
19
|
+
};
|
|
20
|
+
}
|
|
21
|
+
/** 吹き出しの置き方(@balloon on)。 */
|
|
22
|
+
export interface Balloon {
|
|
23
|
+
width?: number;
|
|
24
|
+
/** 話者の立ち絵が出ていないときに置く左上(px)。書かなければ、立ち絵の無い台詞はメッセージ枠で出す。 */
|
|
25
|
+
x?: number;
|
|
26
|
+
y?: number;
|
|
27
|
+
/** 尾の向き(立ち絵の無い吹き出しのもの。auto は下。立ち絵があれば立ち絵へ向ける)・尾を出さない(none)。 */
|
|
28
|
+
tail?: "auto" | "down" | "up" | "none";
|
|
29
|
+
/** 尾の位置(吹き出しの左端からの px)。書かなければ立ち絵の真ん中(立ち絵が無ければ吹き出しの真ん中)。 */
|
|
30
|
+
tailX?: number;
|
|
31
|
+
}
|
|
32
|
+
export interface Sprite {
|
|
33
|
+
/** 差分(表情・ポーズ)。 */
|
|
34
|
+
variant: string;
|
|
35
|
+
/** 立ち絵セット。空文字はキャストの既定(描画側が defaultAppearance → default → 最初のもの、の順に選ぶ)。 */
|
|
36
|
+
appearance: string;
|
|
37
|
+
/** 立ち位置。差分の枠の positions の名前か "auto"(auto の立ち絵どうしで横に並べる。並べ方は描画側が状態だけから決める)。 */
|
|
38
|
+
at: string;
|
|
39
|
+
/** 位置未指定で新しい自動配置に入った人物。明示位置の人物と区別し、セーブにも残す。 */
|
|
40
|
+
autoLayout?: boolean;
|
|
41
|
+
/**
|
|
42
|
+
* 自動配置の枠(何人の並びの左から何番目か)。新しく来た人物を入れる場所、退場しても動かさない並べ方、人物ごとの定位置を
|
|
43
|
+
* 使う作品だけが残す(@liminalia/lang の assignAutoSlots)。
|
|
44
|
+
*/
|
|
45
|
+
autoSlot?: {
|
|
46
|
+
index: number;
|
|
47
|
+
count: number;
|
|
48
|
+
};
|
|
49
|
+
flip: boolean;
|
|
50
|
+
/** 左端・上端の位置(px)。あれば at より優先する。 */
|
|
51
|
+
x?: number;
|
|
52
|
+
y?: number;
|
|
53
|
+
/** 大きさ(px)。あれば差分の大きさより優先する。 */
|
|
54
|
+
width?: number;
|
|
55
|
+
height?: number;
|
|
56
|
+
/** 重なり順(@chara の z)。大きいほど手前。同じなら出した順(挿入順)。省略は 0。 */
|
|
57
|
+
z?: number;
|
|
58
|
+
/**
|
|
59
|
+
* 立ち絵に付いた、プラグインの状態(std の @emote の漫符など)。@chara で差し替えても残り、立ち絵を消すと一緒に消える。
|
|
60
|
+
* 鍵はプラグインの名前を頭に付ける("std.emote")。
|
|
61
|
+
*/
|
|
62
|
+
extra?: Record<string, Value>;
|
|
63
|
+
}
|
|
64
|
+
/** 音の鳴らし方(@bgm・@se のパラメータ)。ループの位置はミリ秒、pan は -100(左)〜100(右)、rate は再生速度(1 で等速)。 */
|
|
65
|
+
export interface SoundOptions {
|
|
66
|
+
loopStart?: number;
|
|
67
|
+
loopEnd?: number;
|
|
68
|
+
pan?: number;
|
|
69
|
+
rate?: number;
|
|
70
|
+
/** 音のフィルター(@bgm・@se の filter。こもり・電話・無線・広間)。 */
|
|
71
|
+
filter?: SoundFilterState;
|
|
72
|
+
}
|
|
73
|
+
/** 音のフィルター(type は muffled・phone・radio・hall、strength は 0〜100)。 */
|
|
74
|
+
export interface SoundFilterState {
|
|
75
|
+
type: string;
|
|
76
|
+
strength: number;
|
|
77
|
+
}
|
|
78
|
+
/** その話者のボイスに掛け続けているフィルター(@voice-filter。話者のものが無ければすべての話者のもの)。 */
|
|
79
|
+
export declare function voiceFilterFor(stage: Pick<StageState, "voiceFilter">, who: string | null): SoundFilterState | null;
|
|
80
|
+
/** 命令の filter・filter-strength を状態の形にする(none・書いていない・強さ 0 は null)。 */
|
|
81
|
+
export declare function filterArg(a: Readonly<Record<string, unknown>>): SoundFilterState | null;
|
|
82
|
+
/** 画面と音の状態。描画側はこれだけを見れば今の画面を組み立て直せる。 */
|
|
83
|
+
/** NVL の読み終えた段落の一片。 */
|
|
84
|
+
export type NvlPart = {
|
|
85
|
+
text: string;
|
|
86
|
+
ruby: string | null;
|
|
87
|
+
style: TextStyle;
|
|
88
|
+
} | {
|
|
89
|
+
br: true;
|
|
90
|
+
};
|
|
91
|
+
export interface NvlPage {
|
|
92
|
+
speaker: string | null;
|
|
93
|
+
label?: string;
|
|
94
|
+
parts: NvlPart[];
|
|
95
|
+
/**
|
|
96
|
+
* 本文の行の元(書いたファイル、原文、場面、{name …} の原文)。別の言語でロードしたときに、今の言語の本文と名前を作り直す
|
|
97
|
+
* (Runtime.retranslate)。前の版のセーブには無く、そのページは書いたときの言語のまま出す。
|
|
98
|
+
*/
|
|
99
|
+
origin?: {
|
|
100
|
+
file: string;
|
|
101
|
+
source: string;
|
|
102
|
+
context?: string;
|
|
103
|
+
name?: string;
|
|
104
|
+
id?: string;
|
|
105
|
+
};
|
|
106
|
+
/**
|
|
107
|
+
* 本文の流れに出して選んだ選択肢(ui.choice.position が inline のとき。options は出した文、picked は選んだ番号)。
|
|
108
|
+
* @nvl の間は段落と同じく本文の一部として積まれるので、ロードで出し直す。
|
|
109
|
+
*/
|
|
110
|
+
choice?: {
|
|
111
|
+
options: {
|
|
112
|
+
text: string;
|
|
113
|
+
origin?: TextOrigin;
|
|
114
|
+
}[];
|
|
115
|
+
picked: number;
|
|
116
|
+
};
|
|
117
|
+
}
|
|
118
|
+
export interface StageState {
|
|
119
|
+
background: string | null;
|
|
120
|
+
/** 単色の背景(@bg color=・@scene-change bg-color=。#rrggbb など)。background があればそちらが勝ち、背景の絵を出す命令で外れる。 */
|
|
121
|
+
backgroundColor?: string;
|
|
122
|
+
/**
|
|
123
|
+
* 奥行きのある背景の絵(@plane)。名前 → 絵(bgimage)と奥行き(0 は立ち絵と同じに動き、1 に近いほどカメラが動いても動かない。
|
|
124
|
+
* 負なら手前で、より大きく動く)。front は立ち絵より手前に置く。@bg で外れる。
|
|
125
|
+
*/
|
|
126
|
+
planes?: Record<string, {
|
|
127
|
+
image: string;
|
|
128
|
+
depth: number;
|
|
129
|
+
front?: boolean;
|
|
130
|
+
}>;
|
|
131
|
+
/** 表示中の立ち絵。キーはキャスト名。重なり順は z、同じなら挿入順。 */
|
|
132
|
+
sprites: Record<string, Sprite>;
|
|
133
|
+
/** 立ち絵を表示していないキャラクターの、顔ウィンドウの表情(@face。立ち絵を消したときは消す前のもの)。キーはキャスト名。 */
|
|
134
|
+
faces?: Record<string, {
|
|
135
|
+
appearance: string;
|
|
136
|
+
variant: string;
|
|
137
|
+
}>;
|
|
138
|
+
/** @face で出した顔(ui.face の show が explicit のとき、これだけを出す)。@face-off で消える。 */
|
|
139
|
+
faceShown?: {
|
|
140
|
+
who: string;
|
|
141
|
+
appearance: string;
|
|
142
|
+
variant: string;
|
|
143
|
+
};
|
|
144
|
+
/** メッセージウィンドウの背景の画像(@window-image)。省略は ui.message.image。 */
|
|
145
|
+
windowImage?: string;
|
|
146
|
+
/**
|
|
147
|
+
* paused は @pause-bgm で一時停止しているとき true。pausedAt は止めた位置(秒。描画側が書く)で、ロードしたあとの @resume-bgm はそこから続ける。
|
|
148
|
+
*/
|
|
149
|
+
bgm: ({
|
|
150
|
+
file: string;
|
|
151
|
+
volume: number;
|
|
152
|
+
loop: boolean;
|
|
153
|
+
paused?: boolean;
|
|
154
|
+
pausedAt?: number;
|
|
155
|
+
} & SoundOptions) | null;
|
|
156
|
+
/** ループ再生中の効果音(チャンネルごと)。単発の効果音は状態に残らない。 */
|
|
157
|
+
loopingSe: Record<string, {
|
|
158
|
+
file: string;
|
|
159
|
+
volume: number;
|
|
160
|
+
paused?: boolean;
|
|
161
|
+
} & SoundOptions>;
|
|
162
|
+
window: boolean;
|
|
163
|
+
/** 暗転・場面転換などで、次の本文まで一時的に枠を隠している。@window hide とは別。 */
|
|
164
|
+
windowSuppressed?: boolean;
|
|
165
|
+
/** @window hide で消したまま(show するまで true)。消していなければ、本文の前にウィンドウを自動で出す。 */
|
|
166
|
+
windowHidden?: boolean;
|
|
167
|
+
/** 画面全体に文章を積んでいく表示(@nvl on)。省略は false。 */
|
|
168
|
+
nvl?: boolean;
|
|
169
|
+
/** NVL の見た目の名前(@nvl on style=。liminalia.json の ui.nvlStyles)。省略は ui.nvl の見た目。 */
|
|
170
|
+
nvlStyle?: string;
|
|
171
|
+
/** 今の NVL の画面に積んである、読み終えた段落(ロードで出し直す)。@clear や表示の切り替えで消える。 */
|
|
172
|
+
nvlPages?: NvlPage[];
|
|
173
|
+
/**
|
|
174
|
+
* クリックを待たずに次へ進んだページ(行の最後の {noclick})の本文。次のページを出すまでメッセージウィンドウに残るので、
|
|
175
|
+
* その間のセーブ(選択肢など)をロードしたら出し直す。次のページ、@clear、@window hide、表示の切り替えで消える。
|
|
176
|
+
*/
|
|
177
|
+
noclickPage?: NvlPage;
|
|
178
|
+
/** 本文の縦書き(@vertical)。省略は作品の設定(ui.message.vertical)。 */
|
|
179
|
+
vertical?: boolean;
|
|
180
|
+
mask: string | null;
|
|
181
|
+
camera: {
|
|
182
|
+
zoom: number;
|
|
183
|
+
x: number;
|
|
184
|
+
y: number;
|
|
185
|
+
rotate: number;
|
|
186
|
+
};
|
|
187
|
+
/** 一文字あたりのミリ秒。null は設定画面の値。 */
|
|
188
|
+
textSpeed: number | null;
|
|
189
|
+
/** 作品固有の命令が持つ状態。 */
|
|
190
|
+
extra: Record<string, Value>;
|
|
191
|
+
/** システム画面への要求のうち、続いている状態(@menu-button・@shortcuts・@backlog)。省略は既定(すべて true)。 */
|
|
192
|
+
ui?: {
|
|
193
|
+
menuButton: boolean;
|
|
194
|
+
shortcuts: boolean;
|
|
195
|
+
backlog: boolean;
|
|
196
|
+
};
|
|
197
|
+
/** ボイス。next は次の台詞で鳴らすもの(@voice)、auto は話者ごとの連番の自動再生(@voice-auto)。省略は何もない。 */
|
|
198
|
+
voice?: {
|
|
199
|
+
next?: VoiceCue | null;
|
|
200
|
+
auto?: Record<string, VoiceAuto>;
|
|
201
|
+
};
|
|
202
|
+
/** ボイスに掛け続ける音のフィルター(@voice-filter)。キーは話者名、"" はすべての話者。省略は掛けない。 */
|
|
203
|
+
voiceFilter?: Record<string, SoundFilterState>;
|
|
204
|
+
/** 立ち絵の振る舞い(@chara-config)。省略した項目は作品の設定(ui.chara)、それも無ければ既定(目立たせない、跳ねない)。 */
|
|
205
|
+
spriteConfig?: SpriteConfig;
|
|
206
|
+
/** 話者の名前欄に出す名前(@name)。キーは話者名。話者ごとの処理(口パク、ボイスなど)は話者名のまま。 */
|
|
207
|
+
names?: Record<string, string>;
|
|
208
|
+
/** 文字を出すときの音(@text-sound)。キーは話者名、"" はほかのすべて。 */
|
|
209
|
+
textSound?: Record<string, {
|
|
210
|
+
file: string;
|
|
211
|
+
volume: number;
|
|
212
|
+
every: number;
|
|
213
|
+
}>;
|
|
214
|
+
/** 吹き出し(@balloon on)。省略・null はメッセージ枠。 */
|
|
215
|
+
balloon?: Balloon | null;
|
|
216
|
+
/** 立ち絵の色調(@tone)。キーはキャスト名、"" はすべての立ち絵。値は色調の名前。背景の色調より先に効く。 */
|
|
217
|
+
tones?: Record<string, string>;
|
|
218
|
+
/**
|
|
219
|
+
* @bg(@scene-change)の tone= で決めた背景の色調(none なら掛けない)。image はその背景で、背景がほかの絵に替わったら効かない。
|
|
220
|
+
* 省略は liminalia.json の ui.backgroundTones(描画側が背景の名前で引く)。
|
|
221
|
+
*/
|
|
222
|
+
backgroundTone?: {
|
|
223
|
+
image: string;
|
|
224
|
+
tone: string;
|
|
225
|
+
};
|
|
226
|
+
/**
|
|
227
|
+
* 被写界深度(@dof)。on のところにピントを合わせ、ほかをぼかす(blur は px)。chara は who の立ち絵に合わせ、
|
|
228
|
+
* 背景とほかの立ち絵をぼかす。省略・null はぼかさない。
|
|
229
|
+
*/
|
|
230
|
+
dof?: {
|
|
231
|
+
on: "background" | "sprites" | "chara";
|
|
232
|
+
who?: string;
|
|
233
|
+
blur: number;
|
|
234
|
+
} | null;
|
|
235
|
+
/**
|
|
236
|
+
* 場面の切れ目まで待たせている命令(@notify when=scene-break。命令の ctx.atSceneBreak)。セーブに入るので、待っている間に
|
|
237
|
+
* セーブとロードをしても消えない。due は場面の切れ目を過ぎた数(先頭から)で、次の本文か選択肢の前に描画側へ渡して外す
|
|
238
|
+
* (外したあとのセーブには入らないので、ロードで二度出ない)。省略は待っているものが無い。
|
|
239
|
+
*/
|
|
240
|
+
sceneWait?: SceneWait;
|
|
241
|
+
}
|
|
242
|
+
/** 場面の切れ目まで待たせている命令(StageState.sceneWait)。 */
|
|
243
|
+
export interface SceneWait {
|
|
244
|
+
commands: {
|
|
245
|
+
name: string;
|
|
246
|
+
args: Record<string, Value>;
|
|
247
|
+
}[];
|
|
248
|
+
due?: number;
|
|
249
|
+
}
|
|
250
|
+
export interface SpriteConfig {
|
|
251
|
+
/** 話していないキャラクターの見せ方(省略は作品の設定 ui.chara.focus。それも無ければ none)。 */
|
|
252
|
+
focus?: "none" | "dim" | "blur" | "dim-blur" | "lower" | "dim-lower";
|
|
253
|
+
dim?: number;
|
|
254
|
+
/** 下げる量(px)。 */
|
|
255
|
+
lower?: number;
|
|
256
|
+
jump?: boolean;
|
|
257
|
+
/** 自動配置で並べ直す時間(ミリ秒)。 */
|
|
258
|
+
moveTime?: number;
|
|
259
|
+
easing?: string;
|
|
260
|
+
}
|
|
261
|
+
/** 鳴らすボイス一つ。folder は素材のフォルダ(voice か sound)。 */
|
|
262
|
+
export interface VoiceCue {
|
|
263
|
+
file: string;
|
|
264
|
+
volume: number;
|
|
265
|
+
folder: string;
|
|
266
|
+
/** 連番のボイス(@voice-auto)なら番号。 */
|
|
267
|
+
n?: number;
|
|
268
|
+
/** 字幕(@voice の caption。本文に書いていない声)。 */
|
|
269
|
+
caption?: string;
|
|
270
|
+
/** ボイスのチャンネル(1 から。省略は 1)。同じチャンネルのボイスは置き換わり、違うチャンネルなら同時に鳴る。 */
|
|
271
|
+
channel?: number;
|
|
272
|
+
/** このボイスの話者(@voice の who。省略はそのページの話者)。口パクと名前欄に使う。 */
|
|
273
|
+
who?: string;
|
|
274
|
+
/** 音のフィルター(@voice の filter か、@voice-filter で掛け続けているもの)。null は掛けない(@voice filter=none)。 */
|
|
275
|
+
filter?: SoundFilterState | null;
|
|
276
|
+
/** 同じページで同時に鳴らすボイス(二人が同時に話す。二つ目の @voice か channel=2)。 */
|
|
277
|
+
also?: VoiceCue[];
|
|
278
|
+
}
|
|
279
|
+
/**
|
|
280
|
+
* 話者の連番のボイス。pattern の {n}({n:3} なら 3 桁)を next に置き換えたファイルを鳴らし、鳴らすたびに next を一つ進める。
|
|
281
|
+
* off は止めている間 true(番号は保つ)。
|
|
282
|
+
*/
|
|
283
|
+
export interface VoiceAuto {
|
|
284
|
+
pattern: string;
|
|
285
|
+
next: number;
|
|
286
|
+
volume: number;
|
|
287
|
+
folder: string;
|
|
288
|
+
off?: boolean;
|
|
289
|
+
}
|
|
290
|
+
/**
|
|
291
|
+
* 呼び出しの記録(@call・マクロ・@with の中身)。return は戻る位置、locals は戻ったときの局所変数。
|
|
292
|
+
* result はマクロの戻り値(@return (式))を入れる変数、content は @with で渡された中身の実行単位の id(マクロの中の @content が入る)。
|
|
293
|
+
*/
|
|
294
|
+
export interface CallFrame {
|
|
295
|
+
return: Position;
|
|
296
|
+
locals: Scope;
|
|
297
|
+
result?: string;
|
|
298
|
+
content?: string;
|
|
299
|
+
/**
|
|
300
|
+
* 場面の呼び出し(Runtime.callScene)。呼んだ場面が次のラベルかファイルの終わりに着いたら、@return を書かなくても return へ戻る。
|
|
301
|
+
* 場面の中で @jump したり、選択肢でほかへ飛んだりしたら、戻らずにこの枠を捨てる。
|
|
302
|
+
*/
|
|
303
|
+
scene?: true;
|
|
304
|
+
}
|
|
305
|
+
/** @sleep-game・@checkpoint で取っておく、ある時点の状態。 */
|
|
306
|
+
export interface Snapshot {
|
|
307
|
+
position: Position;
|
|
308
|
+
locals: Scope;
|
|
309
|
+
callStack: CallFrame[];
|
|
310
|
+
game: Scope;
|
|
311
|
+
stage: StageState;
|
|
312
|
+
seed: number;
|
|
313
|
+
visits?: Record<string, number>;
|
|
314
|
+
chosen?: Record<string, number>;
|
|
315
|
+
variants?: Record<string, number[]>;
|
|
316
|
+
}
|
|
317
|
+
/** セーブデータ。この値を JSON にして保存し、そのまま戻せば再開できる。 */
|
|
318
|
+
export interface SaveData {
|
|
319
|
+
/** セーブの形の版(save.ts の SAVE_VERSION)。読み込むときに今の版へ変換する。 */
|
|
320
|
+
version: number;
|
|
321
|
+
position: Position;
|
|
322
|
+
locals: Scope;
|
|
323
|
+
callStack: CallFrame[];
|
|
324
|
+
game: Scope;
|
|
325
|
+
stage: StageState;
|
|
326
|
+
seed: number;
|
|
327
|
+
/** @sleep-game で取っておいた状態(@awake-game で戻る)。 */
|
|
328
|
+
sleep?: Snapshot | null;
|
|
329
|
+
/** @checkpoint で名前を付けて取っておいた状態。 */
|
|
330
|
+
checkpoints?: Record<string, Snapshot>;
|
|
331
|
+
/** このプレイでラベル(`ファイル#ラベル`)とファイルの頭(`ファイル`)に入った回数(式の visits())。無ければ 0。 */
|
|
332
|
+
visits?: Record<string, number>;
|
|
333
|
+
/** このプレイで選んだ選択肢の文(飾りを外した原文)→ 回数(式の chosen())。 */
|
|
334
|
+
chosen?: Record<string, number>;
|
|
335
|
+
/**
|
|
336
|
+
* 本文の出し分け({seq a|b} など)を通った回数と、前に出したものの番号(出していなければ -1)。鍵はファイルと原文のハッシュと、
|
|
337
|
+
* その文の何番目の出し分けか(`ファイル#ハッシュ:番号`。同じファイルの同じ文の行は数を分け合う)。
|
|
338
|
+
*/
|
|
339
|
+
variants?: Record<string, number[]>;
|
|
340
|
+
/**
|
|
341
|
+
* 作品の版(liminalia.json の version。Runtime の options.gameVersion)。セーブするときに今の版を入れる。
|
|
342
|
+
* 式の save.version で読む(ロードしたプレイはそのセーブを作った版、新しく始めたプレイは今の版。版を入れる前のセーブには無く、空として読む)。
|
|
343
|
+
*/
|
|
344
|
+
gameVersion?: string;
|
|
345
|
+
}
|
|
346
|
+
export interface GameState extends SaveData {
|
|
347
|
+
/** そのプレイ中だけの変数。セーブには入らない。 */
|
|
348
|
+
temp: Scope;
|
|
349
|
+
}
|
|
350
|
+
export declare function initialStage(): StageState;
|
|
351
|
+
export declare function createState(unit: string, seed?: number): GameState;
|
|
352
|
+
export declare function toSaveData(state: GameState): SaveData;
|
|
353
|
+
/**
|
|
354
|
+
* 状態の深い写し。状態はセーブ(JSON)に書ける値だけなので、配列とふつうのオブジェクトを辿って写す。
|
|
355
|
+
* structuredClone と同じ結果だが、台詞ごとに取る写し(再開の控え)では数倍速い。ふつうでないもの(Map、Date など)はそこだけ structuredClone にする。
|
|
356
|
+
*/
|
|
357
|
+
export declare function clonePlain<T>(value: T): T;
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
import { type Expr } from "@liminalia/lang";
|
|
2
|
+
/** 実行時の値。セーブデータにそのまま入る(JSON にできるものだけ)。 */
|
|
3
|
+
export type Value = null | boolean | number | string | Value[] | {
|
|
4
|
+
[key: string]: Value;
|
|
5
|
+
};
|
|
6
|
+
export type Scope = Record<string, Value>;
|
|
7
|
+
export declare class EvalError extends Error {
|
|
8
|
+
}
|
|
9
|
+
export interface EvalEnv {
|
|
10
|
+
/** game / system / temp と局所変数。 */
|
|
11
|
+
lookup(name: string): Value;
|
|
12
|
+
random(): number;
|
|
13
|
+
/**
|
|
14
|
+
* 実行器が答える関数(@liminalia/lang の STORY_FUNCTIONS: visits・read・chosen・lang・platform・app・replaying・chapter・endings)。
|
|
15
|
+
* 引数の数と型は確かめてから渡す。無ければ、まだ何も無いときの値(0・false・""・"pc")。
|
|
16
|
+
*/
|
|
17
|
+
story?(name: string, args: Value[]): Value;
|
|
18
|
+
/**
|
|
19
|
+
* @function で作った式の関数を探す(無ければ undefined)。file を渡せばそのファイルから(関数の中から呼ぶ関数は、書いたファイルから探す)。
|
|
20
|
+
* 組み込みの関数と同じ名前は呼ばない(検査がエラーにする)。
|
|
21
|
+
*/
|
|
22
|
+
fn?(name: string, file?: string): {
|
|
23
|
+
file: string;
|
|
24
|
+
params: readonly string[];
|
|
25
|
+
body: Expr;
|
|
26
|
+
} | undefined;
|
|
27
|
+
/** @function の呼び出しの深さ(実行器は書かない。中で数える)。 */
|
|
28
|
+
depth?: number;
|
|
29
|
+
}
|
|
30
|
+
/** @function の呼び出しの深さの上限(自分を呼ぶ関数が終わらないとき)。 */
|
|
31
|
+
export declare const MAX_FUNCTION_DEPTH = 200;
|
|
32
|
+
/**
|
|
33
|
+
* 式を評価する。暗黙の型変換はしない。例外は + の文字列連結(片方が文字列なら文字列にする)だけ。
|
|
34
|
+
* 未設定の変数や存在しないメンバーは null になる。__proto__、constructor、prototype のメンバーと添字も null
|
|
35
|
+
* (オブジェクトのプロトタイプを読ませない。代入は実行器がエラーにする)。
|
|
36
|
+
*/
|
|
37
|
+
export declare function evaluate(expr: Expr, env: EvalEnv): Value;
|
|
38
|
+
/** 偽になるのは false・null・0・"" だけ。 */
|
|
39
|
+
export declare function truthy(v: Value): boolean;
|
|
40
|
+
export declare function equals(a: Value, b: Value): boolean;
|
|
41
|
+
export declare function display(v: Value): string;
|
|
42
|
+
export declare function checkedDivision(a: number, b: number, op: "/" | "%"): number;
|
|
43
|
+
type PluginFunctionImpl = (args: Value[], env: {
|
|
44
|
+
random(): number;
|
|
45
|
+
}) => Value;
|
|
46
|
+
/**
|
|
47
|
+
* そのプラグインが足す式の関数の処理を入れ替える(そのプラグインが前に入れたものは外す。ほかのプラグインのものは残す。
|
|
48
|
+
* 引数の数は @liminalia/lang の setPluginFunctions)。
|
|
49
|
+
*/
|
|
50
|
+
export declare function setPluginFunctionImpls(plugin: string, impls: Readonly<Record<string, PluginFunctionImpl>>): void;
|
|
51
|
+
/** シード付きの乱数(mulberry32)。状態は数値一つなのでセーブできる。 */
|
|
52
|
+
export declare function nextRandom(seed: number): {
|
|
53
|
+
value: number;
|
|
54
|
+
seed: number;
|
|
55
|
+
};
|
|
56
|
+
/**
|
|
57
|
+
* 版を比べる(1.2.10 は 1.2.9 より後。- の後ろの付いた 1.0.0-beta は 1.0.0 より前。頭の v は読まない。空の版はどの版よりも前)。
|
|
58
|
+
* a が前なら負、同じなら 0、後なら正。デスクトップ版の更新(packages/desktop/update.cjs の compareVersions)と同じ決まり。
|
|
59
|
+
*/
|
|
60
|
+
export declare function compareVersions(a: string, b: string): number;
|
|
61
|
+
export {};
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
import { type Script } from "@liminalia/lang";
|
|
2
|
+
import type { RuntimeOptions } from "./runtime.js";
|
|
3
|
+
/**
|
|
4
|
+
* 「はじめから」を画面なしで何通りか流し、台詞の鍵(voiceLines)→ 鳴った連番を集める(lim voice-lock と制作画面の「番号を固定」)。
|
|
5
|
+
* 固定がまだ無いときに、今の数え方で鳴る番号をそのまま固定するために使う。選び方は、まだ試していないものへ広げていく
|
|
6
|
+
* (全ルートテストと同じ。route.ts の explore)。runs は流す回数の上限で、選び方を試し終えたら早く止める。
|
|
7
|
+
* 数え方の番号を見るので、渡した設定に番号の固定(voiceLock)があっても使わない(使うと、固定に無い台詞が鳴らない)。
|
|
8
|
+
*/
|
|
9
|
+
export declare function observeVoiceNumbers(o: {
|
|
10
|
+
scripts: ReadonlyMap<string, Script>;
|
|
11
|
+
entry: string;
|
|
12
|
+
loadSource(file: string): Promise<string>;
|
|
13
|
+
runtime: RuntimeOptions;
|
|
14
|
+
runs: number;
|
|
15
|
+
/**
|
|
16
|
+
* パック(packs/<フォルダ>/scenario)の台本と、その中身を返す口(パックの台本だけ。無ければ undefined で、本体の台本を読む)。
|
|
17
|
+
* 遊ぶ人はパックのどの組み合わせでも入れうるので、本体にパックを一つずつ、二つずつ…重ねても流し(@liminalia/lang の packCombinations。
|
|
18
|
+
* 遊ぶ側と同じく、同じ名前の台本は後ろのパックのもの)、パックの台本にしか無い台詞の番号を集める(本体にもある台詞は、本体だけで流した番号)。
|
|
19
|
+
* 小さい組から流し、前の組で鳴った台詞には、あとの組で鳴った番号を足さない(組み合わせで番号が変わったと出さないため)。
|
|
20
|
+
* 写す台詞(その組で連番が鳴りうるもの。autoVoicedLines)が残っていない組は流さない。台本のあるパックが PACK_COMBINATION_LIMIT を超えたら、本体に一つずつとすべての組だけ。
|
|
21
|
+
*/
|
|
22
|
+
packs?: readonly {
|
|
23
|
+
scripts: ReadonlyMap<string, Script>;
|
|
24
|
+
source(file: string): string | undefined;
|
|
25
|
+
}[];
|
|
26
|
+
}): Promise<Map<string, Set<number>>>;
|
package/README.md
DELETED