Add setting "Preloading rules"

Signed-off-by: William So <polyipseity@gmail.com>

.changeset/great-parrots-admire.md

@@ -0,0 +1,5 @@
+---
+"obsidian-modules": minor
+---
+
+Add setting "Preloading rules".

README.md

@@ -87,7 +87,9 @@ eat(2 * pi)
 const mod = await self.require.import("[[module]]")
 mod.eat(2 * mod.pi)
 ```
-- To create a module, create a JavaScript file or a Markdown file with JavaScript code blocks. For `require` (but not `require.import`), the file needs to have one of the following extensions: `.js`, `.mjs`, `.js.md`, `.mjs.md`. We recommend that your modules do not have global or side effects because modules are cached and thus not reloaded on every request.
+- To create a module, create a JavaScript file or a Markdown file with JavaScript code blocks.
+	- For `require` (but not `require.import`), the module file needs to be preloaded, which can be configured in settings. By default, preloaded files have the following extensions: `.js`, `.mjs`, `.js.md`, `.mjs.md`
+	- Modules should not have global or side effects because they are cached and thus not reloaded on every requiring.
 - Module exports can be CommonJS-style or ES module-style:
 ```JavaScript
 // ES module-style, supported by `require.import`.
@@ -110,7 +112,6 @@ Contributions are welcome!
 
 The todos here, ordered alphabetically, are things planned for the plugin. There are no guarantees that they will be completed. However, we are likely to accept contributions for them.
 
-- Configure preloaded files.
 - Configure accepted code block languages.
 - Autocomplete with JSDoc.
 

assets/locales/af/translation.json

@@ -26,6 +26,9 @@
 		"expose-internal-modules-description-HTML": "<code>obsidian</code>, <code>@codemirror/*</code>, <code>@lezer/*</code>…",
 		"interface": "Interface",
 		"open-changelog-on-update": "$t(generic.open, capitalize) $t(generic.documentations.changelog) on update",
+		"preloading-rules": "Preloading $t(generic.rule_other)",
+		"preloading-rules-description-HTML": "Required for using <code>require</code> (but not <code>require.import</code>). $t(generic.list-description, capitalize)",
+		"preloading-rules-edit": "$t(generic.edit)",
 		"require-name": "Require $t(generic.name)",
 		"require-name-description-invalid": "Using the default as the specified $t(generic.name) is unavailable."
 	}

assets/locales/am/translation.json

@@ -26,6 +26,9 @@
 		"expose-internal-modules-description-HTML": "<code>obsidian</code>, <code>@codemirror/*</code>, <code>@lezer/*</code>…",
 		"interface": "Interface",
 		"open-changelog-on-update": "$t(generic.open, capitalize) $t(generic.documentations.changelog) on update",
+		"preloading-rules": "Preloading $t(generic.rule_other)",
+		"preloading-rules-description-HTML": "Required for using <code>require</code> (but not <code>require.import</code>). $t(generic.list-description, capitalize)",
+		"preloading-rules-edit": "$t(generic.edit)",
 		"require-name": "Require $t(generic.name)",
 		"require-name-description-invalid": "Using the default as the specified $t(generic.name) is unavailable."
 	}

assets/locales/ar/translation.json

@@ -26,6 +26,9 @@
 		"expose-internal-modules-description-HTML": "<code>obsidian</code>, <code>@codemirror/*</code>, <code>@lezer/*</code>…",
 		"interface": "Interface",
 		"open-changelog-on-update": "$t(generic.open, capitalize) $t(generic.documentations.changelog) on update",
+		"preloading-rules": "Preloading $t(generic.rule_other)",
+		"preloading-rules-description-HTML": "Required for using <code>require</code> (but not <code>require.import</code>). $t(generic.list-description, capitalize)",
+		"preloading-rules-edit": "$t(generic.edit)",
 		"require-name": "Require $t(generic.name)",
 		"require-name-description-invalid": "Using the default as the specified $t(generic.name) is unavailable."
 	}

assets/locales/be/translation.json

@@ -26,6 +26,9 @@
 		"expose-internal-modules-description-HTML": "<code>obsidian</code>, <code>@codemirror/*</code>, <code>@lezer/*</code>…",
 		"interface": "Interface",
 		"open-changelog-on-update": "$t(generic.open, capitalize) $t(generic.documentations.changelog) on update",
+		"preloading-rules": "Preloading $t(generic.rule_other)",
+		"preloading-rules-description-HTML": "Required for using <code>require</code> (but not <code>require.import</code>). $t(generic.list-description, capitalize)",
+		"preloading-rules-edit": "$t(generic.edit)",
 		"require-name": "Require $t(generic.name)",
 		"require-name-description-invalid": "Using the default as the specified $t(generic.name) is unavailable."
 	}

assets/locales/bg/translation.json

@@ -26,6 +26,9 @@
 		"expose-internal-modules-description-HTML": "<code>obsidian</code>, <code>@codemirror/*</code>, <code>@lezer/*</code>…",
 		"interface": "Interface",
 		"open-changelog-on-update": "$t(generic.open, capitalize) $t(generic.documentations.changelog) on update",
+		"preloading-rules": "Preloading $t(generic.rule_other)",
+		"preloading-rules-description-HTML": "Required for using <code>require</code> (but not <code>require.import</code>). $t(generic.list-description, capitalize)",
+		"preloading-rules-edit": "$t(generic.edit)",
 		"require-name": "Require $t(generic.name)",
 		"require-name-description-invalid": "Using the default as the specified $t(generic.name) is unavailable."
 	}

assets/locales/bn/translation.json

@@ -26,6 +26,9 @@
 		"expose-internal-modules-description-HTML": "<code>obsidian</code>, <code>@codemirror/*</code>, <code>@lezer/*</code>…",
 		"interface": "Interface",
 		"open-changelog-on-update": "$t(generic.open, capitalize) $t(generic.documentations.changelog) on update",
+		"preloading-rules": "Preloading $t(generic.rule_other)",
+		"preloading-rules-description-HTML": "Required for using <code>require</code> (but not <code>require.import</code>). $t(generic.list-description, capitalize)",
+		"preloading-rules-edit": "$t(generic.edit)",
 		"require-name": "Require $t(generic.name)",
 		"require-name-description-invalid": "Using the default as the specified $t(generic.name) is unavailable."
 	}

assets/locales/ca/translation.json

@@ -26,6 +26,9 @@
 		"expose-internal-modules-description-HTML": "<code>obsidian</code>, <code>@codemirror/*</code>, <code>@lezer/*</code>…",
 		"interface": "Interface",
 		"open-changelog-on-update": "$t(generic.open, capitalize) $t(generic.documentations.changelog) on update",
+		"preloading-rules": "Preloading $t(generic.rule_other)",
+		"preloading-rules-description-HTML": "Required for using <code>require</code> (but not <code>require.import</code>). $t(generic.list-description, capitalize)",
+		"preloading-rules-edit": "$t(generic.edit)",
 		"require-name": "Require $t(generic.name)",
 		"require-name-description-invalid": "Using the default as the specified $t(generic.name) is unavailable."
 	}

assets/locales/cs/translation.json

@@ -26,6 +26,9 @@
 		"expose-internal-modules-description-HTML": "<code>obsidian</code>, <code>@codemirror/*</code>, <code>@lezer/*</code>…",
 		"interface": "Interface",
 		"open-changelog-on-update": "$t(generic.open, capitalize) $t(generic.documentations.changelog) on update",
+		"preloading-rules": "Preloading $t(generic.rule_other)",
+		"preloading-rules-description-HTML": "Required for using <code>require</code> (but not <code>require.import</code>). $t(generic.list-description, capitalize)",
+		"preloading-rules-edit": "$t(generic.edit)",
 		"require-name": "Require $t(generic.name)",
 		"require-name-description-invalid": "Using the default as the specified $t(generic.name) is unavailable."
 	}

assets/locales/da/translation.json

@@ -26,6 +26,9 @@
 		"expose-internal-modules-description-HTML": "<code>obsidian</code>, <code>@codemirror/*</code>, <code>@lezer/*</code>…",
 		"interface": "Interface",
 		"open-changelog-on-update": "$t(generic.open, capitalize) $t(generic.documentations.changelog) on update",
+		"preloading-rules": "Preloading $t(generic.rule_other)",
+		"preloading-rules-description-HTML": "Required for using <code>require</code> (but not <code>require.import</code>). $t(generic.list-description, capitalize)",
+		"preloading-rules-edit": "$t(generic.edit)",
 		"require-name": "Require $t(generic.name)",
 		"require-name-description-invalid": "Using the default as the specified $t(generic.name) is unavailable."
 	}

assets/locales/de/translation.json

@@ -26,6 +26,9 @@
 		"expose-internal-modules-description-HTML": "<code>obsidian</code>, <code>@codemirror/*</code>, <code>@lezer/*</code>…",
 		"interface": "Interface",
 		"open-changelog-on-update": "$t(generic.open, capitalize) $t(generic.documentations.changelog) on update",
+		"preloading-rules": "Preloading $t(generic.rule_other)",
+		"preloading-rules-description-HTML": "Required for using <code>require</code> (but not <code>require.import</code>). $t(generic.list-description, capitalize)",
+		"preloading-rules-edit": "$t(generic.edit)",
 		"require-name": "Require $t(generic.name)",
 		"require-name-description-invalid": "Using the default as the specified $t(generic.name) is unavailable."
 	}

assets/locales/el/translation.json

@@ -26,6 +26,9 @@
 		"expose-internal-modules-description-HTML": "<code>obsidian</code>, <code>@codemirror/*</code>, <code>@lezer/*</code>…",
 		"interface": "Interface",
 		"open-changelog-on-update": "$t(generic.open, capitalize) $t(generic.documentations.changelog) on update",
+		"preloading-rules": "Preloading $t(generic.rule_other)",
+		"preloading-rules-description-HTML": "Required for using <code>require</code> (but not <code>require.import</code>). $t(generic.list-description, capitalize)",
+		"preloading-rules-edit": "$t(generic.edit)",
 		"require-name": "Require $t(generic.name)",
 		"require-name-description-invalid": "Using the default as the specified $t(generic.name) is unavailable."
 	}

assets/locales/en/asset.json

@@ -19,6 +19,8 @@
 		},
 		"expose-internal-modules-icon": "puzzle",
 		"open-changelog-on-update-icon": "$t(asset:generic.documentations.changelog-icon)",
+		"preloading-rules-edit-icon": "$t(asset:generic.edit-list-icon)",
+		"preloading-rules-icon": "$t(asset:generic.rule-icon)",
 		"require-name-icon": "key"
 	}
 }

assets/locales/en/translation.json

@@ -26,6 +26,9 @@
 		"expose-internal-modules-description-HTML": "<code>obsidian</code>, <code>@codemirror/*</code>, <code>@lezer/*</code>…",
 		"interface": "Interface",
 		"open-changelog-on-update": "$t(generic.open, capitalize) $t(generic.documentations.changelog) on update",
+		"preloading-rules": "Preloading $t(generic.rule_other)",
+		"preloading-rules-description-HTML": "Required for using <code>require</code> (but not <code>require.import</code>). $t(generic.list-description, capitalize)",
+		"preloading-rules-edit": "$t(generic.edit)",
 		"require-name": "Require $t(generic.name)",
 		"require-name-description-invalid": "Using the default as the specified $t(generic.name) is unavailable."
 	}

assets/locales/eo/translation.json

@@ -26,6 +26,9 @@
 		"expose-internal-modules-description-HTML": "<code>obsidian</code>, <code>@codemirror/*</code>, <code>@lezer/*</code>…",
 		"interface": "Interface",
 		"open-changelog-on-update": "$t(generic.open, capitalize) $t(generic.documentations.changelog) on update",
+		"preloading-rules": "Preloading $t(generic.rule_other)",
+		"preloading-rules-description-HTML": "Required for using <code>require</code> (but not <code>require.import</code>). $t(generic.list-description, capitalize)",
+		"preloading-rules-edit": "$t(generic.edit)",
 		"require-name": "Require $t(generic.name)",
 		"require-name-description-invalid": "Using the default as the specified $t(generic.name) is unavailable."
 	}

assets/locales/es/translation.json

@@ -26,6 +26,9 @@
 		"expose-internal-modules-description-HTML": "<code>obsidian</code>, <code>@codemirror/*</code>, <code>@lezer/*</code>…",
 		"interface": "Interface",
 		"open-changelog-on-update": "$t(generic.open, capitalize) $t(generic.documentations.changelog) on update",
+		"preloading-rules": "Preloading $t(generic.rule_other)",
+		"preloading-rules-description-HTML": "Required for using <code>require</code> (but not <code>require.import</code>). $t(generic.list-description, capitalize)",
+		"preloading-rules-edit": "$t(generic.edit)",
 		"require-name": "Require $t(generic.name)",
 		"require-name-description-invalid": "Using the default as the specified $t(generic.name) is unavailable."
 	}

assets/locales/eu/translation.json

@@ -26,6 +26,9 @@
 		"expose-internal-modules-description-HTML": "<code>obsidian</code>, <code>@codemirror/*</code>, <code>@lezer/*</code>…",
 		"interface": "Interface",
 		"open-changelog-on-update": "$t(generic.open, capitalize) $t(generic.documentations.changelog) on update",
+		"preloading-rules": "Preloading $t(generic.rule_other)",
+		"preloading-rules-description-HTML": "Required for using <code>require</code> (but not <code>require.import</code>). $t(generic.list-description, capitalize)",
+		"preloading-rules-edit": "$t(generic.edit)",
 		"require-name": "Require $t(generic.name)",
 		"require-name-description-invalid": "Using the default as the specified $t(generic.name) is unavailable."
 	}

assets/locales/fa/translation.json

@@ -26,6 +26,9 @@
 		"expose-internal-modules-description-HTML": "<code>obsidian</code>, <code>@codemirror/*</code>, <code>@lezer/*</code>…",
 		"interface": "Interface",
 		"open-changelog-on-update": "$t(generic.open, capitalize) $t(generic.documentations.changelog) on update",
+		"preloading-rules": "Preloading $t(generic.rule_other)",
+		"preloading-rules-description-HTML": "Required for using <code>require</code> (but not <code>require.import</code>). $t(generic.list-description, capitalize)",
+		"preloading-rules-edit": "$t(generic.edit)",
 		"require-name": "Require $t(generic.name)",
 		"require-name-description-invalid": "Using the default as the specified $t(generic.name) is unavailable."
 	}

assets/locales/fi/translation.json

@@ -26,6 +26,9 @@
 		"expose-internal-modules-description-HTML": "<code>obsidian</code>, <code>@codemirror/*</code>, <code>@lezer/*</code>…",
 		"interface": "Interface",
 		"open-changelog-on-update": "$t(generic.open, capitalize) $t(generic.documentations.changelog) on update",
+		"preloading-rules": "Preloading $t(generic.rule_other)",
+		"preloading-rules-description-HTML": "Required for using <code>require</code> (but not <code>require.import</code>). $t(generic.list-description, capitalize)",
+		"preloading-rules-edit": "$t(generic.edit)",
 		"require-name": "Require $t(generic.name)",
 		"require-name-description-invalid": "Using the default as the specified $t(generic.name) is unavailable."
 	}

assets/locales/fr/translation.json

@@ -26,6 +26,9 @@
 		"expose-internal-modules-description-HTML": "<code>obsidian</code>, <code>@codemirror/*</code>, <code>@lezer/*</code>…",
 		"interface": "Interface",
 		"open-changelog-on-update": "$t(generic.open, capitalize) $t(generic.documentations.changelog) on update",
+		"preloading-rules": "Preloading $t(generic.rule_other)",
+		"preloading-rules-description-HTML": "Required for using <code>require</code> (but not <code>require.import</code>). $t(generic.list-description, capitalize)",
+		"preloading-rules-edit": "$t(generic.edit)",
 		"require-name": "Require $t(generic.name)",
 		"require-name-description-invalid": "Using the default as the specified $t(generic.name) is unavailable."
 	}

assets/locales/gl/translation.json

@@ -26,6 +26,9 @@
 		"expose-internal-modules-description-HTML": "<code>obsidian</code>, <code>@codemirror/*</code>, <code>@lezer/*</code>…",
 		"interface": "Interface",
 		"open-changelog-on-update": "$t(generic.open, capitalize) $t(generic.documentations.changelog) on update",
+		"preloading-rules": "Preloading $t(generic.rule_other)",
+		"preloading-rules-description-HTML": "Required for using <code>require</code> (but not <code>require.import</code>). $t(generic.list-description, capitalize)",
+		"preloading-rules-edit": "$t(generic.edit)",
 		"require-name": "Require $t(generic.name)",
 		"require-name-description-invalid": "Using the default as the specified $t(generic.name) is unavailable."
 	}

assets/locales/he/translation.json

@@ -26,6 +26,9 @@
 		"expose-internal-modules-description-HTML": "<code>obsidian</code>, <code>@codemirror/*</code>, <code>@lezer/*</code>…",
 		"interface": "Interface",
 		"open-changelog-on-update": "$t(generic.open, capitalize) $t(generic.documentations.changelog) on update",
+		"preloading-rules": "Preloading $t(generic.rule_other)",
+		"preloading-rules-description-HTML": "Required for using <code>require</code> (but not <code>require.import</code>). $t(generic.list-description, capitalize)",
+		"preloading-rules-edit": "$t(generic.edit)",
 		"require-name": "Require $t(generic.name)",
 		"require-name-description-invalid": "Using the default as the specified $t(generic.name) is unavailable."
 	}

assets/locales/hi/translation.json

@@ -26,6 +26,9 @@
 		"expose-internal-modules-description-HTML": "<code>obsidian</code>, <code>@codemirror/*</code>, <code>@lezer/*</code>…",
 		"interface": "Interface",
 		"open-changelog-on-update": "$t(generic.open, capitalize) $t(generic.documentations.changelog) on update",
+		"preloading-rules": "Preloading $t(generic.rule_other)",
+		"preloading-rules-description-HTML": "Required for using <code>require</code> (but not <code>require.import</code>). $t(generic.list-description, capitalize)",
+		"preloading-rules-edit": "$t(generic.edit)",
 		"require-name": "Require $t(generic.name)",
 		"require-name-description-invalid": "Using the default as the specified $t(generic.name) is unavailable."
 	}

assets/locales/hu/translation.json

@@ -26,6 +26,9 @@
 		"expose-internal-modules-description-HTML": "<code>obsidian</code>, <code>@codemirror/*</code>, <code>@lezer/*</code>…",
 		"interface": "Interface",
 		"open-changelog-on-update": "$t(generic.open, capitalize) $t(generic.documentations.changelog) on update",
+		"preloading-rules": "Preloading $t(generic.rule_other)",
+		"preloading-rules-description-HTML": "Required for using <code>require</code> (but not <code>require.import</code>). $t(generic.list-description, capitalize)",
+		"preloading-rules-edit": "$t(generic.edit)",
 		"require-name": "Require $t(generic.name)",
 		"require-name-description-invalid": "Using the default as the specified $t(generic.name) is unavailable."
 	}

assets/locales/id/translation.json

@@ -26,6 +26,9 @@
 		"expose-internal-modules-description-HTML": "<code>obsidian</code>, <code>@codemirror/*</code>, <code>@lezer/*</code>…",
 		"interface": "Interface",
 		"open-changelog-on-update": "$t(generic.open, capitalize) $t(generic.documentations.changelog) on update",
+		"preloading-rules": "Preloading $t(generic.rule_other)",
+		"preloading-rules-description-HTML": "Required for using <code>require</code> (but not <code>require.import</code>). $t(generic.list-description, capitalize)",
+		"preloading-rules-edit": "$t(generic.edit)",
 		"require-name": "Require $t(generic.name)",
 		"require-name-description-invalid": "Using the default as the specified $t(generic.name) is unavailable."
 	}

assets/locales/it/translation.json

@@ -26,6 +26,9 @@
 		"expose-internal-modules-description-HTML": "<code>obsidian</code>, <code>@codemirror/*</code>, <code>@lezer/*</code>…",
 		"interface": "Interface",
 		"open-changelog-on-update": "$t(generic.open, capitalize) $t(generic.documentations.changelog) on update",
+		"preloading-rules": "Preloading $t(generic.rule_other)",
+		"preloading-rules-description-HTML": "Required for using <code>require</code> (but not <code>require.import</code>). $t(generic.list-description, capitalize)",
+		"preloading-rules-edit": "$t(generic.edit)",
 		"require-name": "Require $t(generic.name)",
 		"require-name-description-invalid": "Using the default as the specified $t(generic.name) is unavailable."
 	}

assets/locales/ja/translation.json

@@ -26,6 +26,9 @@
 		"expose-internal-modules-description-HTML": "<code>obsidian</code>, <code>@codemirror/*</code>, <code>@lezer/*</code>…",
 		"interface": "Interface",
 		"open-changelog-on-update": "$t(generic.open, capitalize) $t(generic.documentations.changelog) on update",
+		"preloading-rules": "Preloading $t(generic.rule_other)",
+		"preloading-rules-description-HTML": "Required for using <code>require</code> (but not <code>require.import</code>). $t(generic.list-description, capitalize)",
+		"preloading-rules-edit": "$t(generic.edit)",
 		"require-name": "Require $t(generic.name)",
 		"require-name-description-invalid": "Using the default as the specified $t(generic.name) is unavailable."
 	}

assets/locales/ko/translation.json

@@ -26,6 +26,9 @@
 		"expose-internal-modules-description-HTML": "<code>obsidian</code>, <code>@codemirror/*</code>, <code>@lezer/*</code>…",
 		"interface": "Interface",
 		"open-changelog-on-update": "$t(generic.open, capitalize) $t(generic.documentations.changelog) on update",
+		"preloading-rules": "Preloading $t(generic.rule_other)",
+		"preloading-rules-description-HTML": "Required for using <code>require</code> (but not <code>require.import</code>). $t(generic.list-description, capitalize)",
+		"preloading-rules-edit": "$t(generic.edit)",
 		"require-name": "Require $t(generic.name)",
 		"require-name-description-invalid": "Using the default as the specified $t(generic.name) is unavailable."
 	}