From 06f7ad98648ae28387ef63850280e1b8f4615db2 Mon Sep 17 00:00:00 2001
From: sup39 <sms@sup39.dev>
Date: Fri, 8 Apr 2022 12:48:37 +0900
Subject: [PATCH] Implement customizable code; add Instant Restart

---
 Codes.xml                                     | 30 ++++++++
 changelog.md                                  | 23 +++++++
 scripts/inject_codes.js                       |  3 +-
 site/.vuepress/components/CodeInfo.vue        |  6 ++
 site/.vuepress/components/DownloadButton.vue  | 12 ++++
 site/.vuepress/components/Generator.vue       |  2 +-
 .../codes/InstantRestart/codegen.js           | 52 ++++++++++++++
 .../codes/InstantRestart/config.vue           | 68 +++++++++++++++++++
 .../codes/InstantRestart/labels.json          | 18 +++++
 site/.vuepress/components/codes/codegen.js    | 17 +++++
 site/.vuepress/components/codes/ui.js         |  5 ++
 11 files changed, 233 insertions(+), 3 deletions(-)
 create mode 100644 site/.vuepress/components/codes/InstantRestart/codegen.js
 create mode 100644 site/.vuepress/components/codes/InstantRestart/config.vue
 create mode 100644 site/.vuepress/components/codes/InstantRestart/labels.json
 create mode 100644 site/.vuepress/components/codes/codegen.js
 create mode 100644 site/.vuepress/components/codes/ui.js

diff --git a/Codes.xml b/Codes.xml
index 1bdbe93..2ebda20 100644
--- a/Codes.xml
+++ b/Codes.xml
@@ -4040,4 +4040,34 @@
           00000000 59800004
       </source>
     </code>
+    <code>
+        <id>InstantRestart</id>
+        <category>qol</category>
+        <presets>recommended</presets>
+        <title lang="en-US">Instant Restart</title>
+        <title lang="ja-JP">ポーズせずにやり直し</title>
+        <author>sup39(サポミク)</author>
+        <version>0.1.3</version>
+        <date>Jan 07, 2022</date>
+        <description lang="en-US">
+          When you pressed the buttons configured in [#Button Config](#config) simultaneously,
+          you can restart the current area without selecting "Exit Area" in pause menu.
+          Note that the restart function behaves differently than pressing Y or Z with "Level Select".
+          This code only supports restarting 1 area only.
+          For example, you can restart outside a secret stage or inside a secret stage individually,
+          but you can NOT restart a combination of outside+inside a secret stage.
+
+          ::: warning
+          You can NOT restart after destroying the last platform in Bowser fight at the moment.
+          :::
+        </description>
+        <description lang="ja-JP">
+          [#ボタン設定](#config)で設定したボタンを同時に押すと、ポーズメニューから「コースから出る」を選択せずに所在のエリアをやり直すことができます。ただし、Level SelectのYとZのやり直し機能と異なり、エリアごとのやり直ししかできないので注意してください。例えば、ヒミツ外部のみ、ヒミツ内部のみといった一つのエリアのやり直しはできますが、ヒミツ外部+ヒミツ内部といった組み合わせのやり直しはできません。
+
+          ::: warning
+          現時点ではクッパ戦で最後の足場を破壊するとやり直しできません。
+          :::
+        </description>
+        <source version="GMSJ01"></source>
+    </code>
 </codes>
diff --git a/changelog.md b/changelog.md
index 2969a0d..e92b7b8 100644
--- a/changelog.md
+++ b/changelog.md
@@ -1,4 +1,27 @@
 # Changelog
+## Apr 08, 2022
+### Implemented customizable code
+- Add code info in `Codes.xml` as other code,
+  but you should specify `<id>` and available versions with `<source version="XXX"></source>`
+  (the code in `<source>` will be ignored).
+- Create directory `site/.vuepress/components/codes/YOUR_CODE_NAME`,
+  and create the following two files (file names are arbitrary):
+  + `codegen.js`: **export default** a `codegen(version: string): string` function,
+    where `version` is the game version (e.g. `GMSJ01`),
+    and the return value is the gecko code string.
+    The config of the code can be read from localStorage
+    (with key = `config/YOUR_CODE_ID` as convention) directly.
+  + `config.vue`: The vue component of the config UI,
+    which is shown below the `<description>` given in `Codes.xml`.
+    When the config is changed, store the new config into localStorage
+    (with key = `config/YOUR_CODE_ID` as convention).
+- Register `codegen.js` in `site/.vuepress/components/codes/codegen.js`
+  and `config.vue` in `site/.vuepress/components/codes/ui.js`.
+  Note that the name used in export must match the `<id>` of the code.
+
+### Added 'Instant Restart' (GMSJ01 only)
+Restarts the area without pausing.
+
 ## Mar 25, 2022
 ### Implemented dependencies system
 Add `<dependencies>` tag in `<code>` (e.g. `<dependencies>dep1,dep2,dep3</dependencies>`)
diff --git a/scripts/inject_codes.js b/scripts/inject_codes.js
index b3edd6f..876a227 100644
--- a/scripts/inject_codes.js
+++ b/scripts/inject_codes.js
@@ -107,8 +107,7 @@ const validateXML = (xmlString) => {
     // Each source has a valid length
     for (let j = 0; j < codeSources.length; j++) {
       if (
-        codeSources[j].textContent.replace(/[\s\n\r\t]+/gm, '').length % 16 != 0 ||
-        codeSources[j].textContent.replace(/[\s\n\r\t]+/gm, '').length < 16
+        codeSources[j].textContent.replace(/[\s\n\r\t]+/gm, '').length % 16 != 0
       )
         throw new Error(
           `Invalid source length for code '${codeTitle.textContent}' and version ${
diff --git a/site/.vuepress/components/CodeInfo.vue b/site/.vuepress/components/CodeInfo.vue
index 1c53ef4..9a031eb 100644
--- a/site/.vuepress/components/CodeInfo.vue
+++ b/site/.vuepress/components/CodeInfo.vue
@@ -11,21 +11,27 @@
       <span v-else>{{ getLabel('codeinfo.author') }} {{ translatedCode.author }}</span>
     </div>
     <p class="description" v-html="translatedCode.description"></p>
+    <component v-if="configUI" :is="configUI" :version="version"></component>
   </div>
 </template>
 
 <script>
 import { translate, translateCode } from '../i18n/localeHelper';
+import configUIs from './codes/ui.js';
 
 export default {
   props: {
     anchor: { type: Boolean },
     code: { type: Object },
+    version: { type: String },
   },
   computed: {
     translatedCode: function () {
       return translateCode(this.code, this.$lang);
     },
+    configUI: function () {
+      return configUIs[this.code.id];
+    },
   },
   data() {
     return {};
diff --git a/site/.vuepress/components/DownloadButton.vue b/site/.vuepress/components/DownloadButton.vue
index 2f21ae3..1c02274 100644
--- a/site/.vuepress/components/DownloadButton.vue
+++ b/site/.vuepress/components/DownloadButton.vue
@@ -15,6 +15,9 @@ import gameVersions from '../data/gameVersions.json';
 // Util
 import { translateCode } from '../i18n/localeHelper';
 
+// customizable code
+import codegens from './codes/codegen.js';
+
 export default {
   props: {
     codes: { type: Array },
@@ -59,6 +62,15 @@ export default {
 
       const fileName = gameVersions.find((v) => v.identifier === this.versionIdentifier).version;
 
+      // apply customizable codes
+      for (const code of c) {
+        const codegen = codegens[code.id];
+        if (codegen) {
+          code.source = codegen(this.versionIdentifier);
+        }
+      }
+
+      // generate file
       switch (this.format) {
         case 'gct':
           this.generateGCT(c, fileName);
diff --git a/site/.vuepress/components/Generator.vue b/site/.vuepress/components/Generator.vue
index 9c73ef5..bba7c80 100644
--- a/site/.vuepress/components/Generator.vue
+++ b/site/.vuepress/components/Generator.vue
@@ -42,7 +42,7 @@
 
       <div v-if="codes && codes.length > 0" class="help">
         <h3>{{ getLabel('headers.help') }}</h3>
-        <CodeInfo v-if="!!inspectingCode" :code="inspectingCode" />
+        <CodeInfo v-if="!!inspectingCode" :code="inspectingCode" :version="selectedVersion" />
         <div v-else-if="showStageLoaderHelp">
           <h3>{{ getLabel('headers.stageloader') }}</h3>
           <div>
diff --git a/site/.vuepress/components/codes/InstantRestart/codegen.js b/site/.vuepress/components/codes/InstantRestart/codegen.js
new file mode 100644
index 0000000..2ca0f6d
--- /dev/null
+++ b/site/.vuepress/components/codes/InstantRestart/codegen.js
@@ -0,0 +1,52 @@
+import { parseJSON } from '../codegen.js';
+export const lskey = 'config/InstantRestart';
+export const buttonValues = {
+  START: 0x1000,
+  Y: 0x0800,
+  X: 0x0400,
+  B: 0x0200,
+  A: 0x0100,
+  L: 0x0040,
+  R: 0x0020,
+  Z: 0x0010,
+  DU: 0x0008,
+  DD: 0x0004,
+  DR: 0x0002,
+  DL: 0x0001,
+};
+
+export const defaultConfig = {
+  button: buttonValues.Y | buttonValues.DL,
+};
+export function getConfig() {
+  return {
+    ...defaultConfig,
+    ...(parseJSON(localStorage.getItem(lskey)) ?? {}),
+  };
+}
+export default function codegen(version) {
+  const { button } = getConfig();
+  let code;
+  switch (version) {
+    case 'GMSJ01':
+      code = `
+c20eafa0 00000009
+3c608040 a0a30d50
+2805${button.toString(16).padStart(4, '0')} 40a20030
+3c60817f 38a00001
+98a300b3 98a30100
+3c60803e 80a3600e
+90a36012 3c60800e
+6063b3f8 7c6803a6
+4e800020 2c000002
+60000000 00000000
+`;
+      if (button & buttonValues.Z) {
+        code += '\n040eb024 60000000';
+      }
+      break;
+    default:
+      return '';
+  }
+  return code.replace(/\s/g, '');
+}
diff --git a/site/.vuepress/components/codes/InstantRestart/config.vue b/site/.vuepress/components/codes/InstantRestart/config.vue
new file mode 100644
index 0000000..164b954
--- /dev/null
+++ b/site/.vuepress/components/codes/InstantRestart/config.vue
@@ -0,0 +1,68 @@
+<template>
+  <div id="config">
+    <h3>{{l('h3Config')}}</h3>
+    <div>
+      <span>{{l('lblButton')}}</span>
+      <div v-for="info in buttonInfos" class="inline" :key="info.value">
+        <input type="checkbox" :checked="button & info.value"
+          @change="toggleButton($event, info.value)"><span>{{info.text}}</span>
+      </div>
+    </div>
+    <div>
+      <span>{{l('lblDPad')}}</span>
+      <div v-for="info in dpadButtonInfos" class="inline" :key="info.value">
+        <input type="checkbox" :checked="button & info.value"
+          @change="toggleButton($event, info.value)"><span>{{info.text}}</span>
+      </div>
+    </div>
+    <div v-if="button & buttonValues.Z" class="custom-block danger">
+      <p>{{l('pCautionZ')}}</p>
+    </div>
+  </div>
+</template>
+
+<script>
+import {getConfig, lskey, buttonValues} from './codegen.js';
+import labels from './labels.json';
+import {getLabels} from '../codegen.js';
+
+export default {
+  methods: {
+    updateConfig() {
+      localStorage.setItem(lskey, JSON.stringify({button: this.button}));
+    },
+    toggleButton(event, value) {
+      this.button = event.target.checked ?
+        this.button | value : // ON
+        this.button & ~value; // OFF
+      this.updateConfig();
+    },
+    l(id) {
+      return labels[id][this.$lang] ?? labels[id]['en-US'];
+    },
+  },
+  data() {
+    const {button} = getConfig();
+    return {
+      button,
+      // const
+      buttonInfos: [
+        'A', 'B', 'X', 'Y', 'L', 'R', 'Z',
+      ].map(text => ({text, value: buttonValues[text]})),
+      dpadButtonInfos: [
+        {text: '←', value: buttonValues.DL},
+        {text: '↓', value: buttonValues.DD},
+        {text: '↑', value: buttonValues.DU},
+        {text: '→', value: buttonValues.DR},
+      ],
+      buttonValues,
+    };
+  },
+}
+</script>
+
+<style>
+.inline {
+  display: inline-block;
+}
+</style>
diff --git a/site/.vuepress/components/codes/InstantRestart/labels.json b/site/.vuepress/components/codes/InstantRestart/labels.json
new file mode 100644
index 0000000..eb785fc
--- /dev/null
+++ b/site/.vuepress/components/codes/InstantRestart/labels.json
@@ -0,0 +1,18 @@
+{
+  "h3Config": {
+    "ja-JP": "ボタン設定",
+    "en-US": "Button Config"
+  },
+  "lblDPad": {
+    "ja-JP": "【十字キー】",
+    "en-US": "D-Pad: "
+  },
+  "lblButton": {
+    "ja-JP": "【ボタン】",
+    "en-US": "Button: "
+  },
+  "pCautionZ": {
+    "ja-JP": "Zメニューが無効化されるので注意してください",
+    "en-US": "Note that Z menu will be disabled."
+  }
+}
diff --git a/site/.vuepress/components/codes/codegen.js b/site/.vuepress/components/codes/codegen.js
new file mode 100644
index 0000000..54c05c6
--- /dev/null
+++ b/site/.vuepress/components/codes/codegen.js
@@ -0,0 +1,17 @@
+import InstantRestart from './InstantRestart/codegen.js';
+
+export default {
+  InstantRestart,
+};
+
+/**
+ * @param {string|null} s -- raw input string
+ */
+export function parseJSON(s) {
+  if (s == null) return null;
+  try {
+    return JSON.parse(s);
+  } catch {
+    return null;
+  }
+}
diff --git a/site/.vuepress/components/codes/ui.js b/site/.vuepress/components/codes/ui.js
new file mode 100644
index 0000000..5c0c8a3
--- /dev/null
+++ b/site/.vuepress/components/codes/ui.js
@@ -0,0 +1,5 @@
+import InstantRestart from './InstantRestart/config.vue';
+
+export default {
+  InstantRestart,
+};