rpgmaker-mz-mcp 1.0.0

package/dist/validation/pluginCommands.d.ts

@@ -0,0 +1,83 @@
+import { EventCommand } from '../utils/types.js';
+import { ValidationWarning } from './eventCommands.js';
+/**
+ * Event command code for an RPG Maker MZ plugin command. On disk a 357 command is
+ * `{ code: 357, indent, parameters: [pluginName, commandName, label, args] }`:
+ *   - parameters[0] — plugin filename without `.js` (e.g. `TextPicture`)
+ *   - parameters[1] — the registered command key the plugin listens for
+ *   - parameters[2] — the editor's display label (cosmetic; the engine ignores it)
+ *   - parameters[3] — an args object `{ name: value }`; the editor stores every
+ *     value as a string (structs/arrays are JSON-stringified into that string).
+ * `command357` only reads [0], [1] and [3]; [2] is purely for the editor's list.
+ */
+export declare const PLUGIN_COMMAND_CODE = 357;
+/** Spec for a single plugin-command argument. */
+export interface PluginArgSpec {
+    name: string;
+    required?: boolean;
+    description?: string;
+    /** The editor's display label (`@text`), when scanned from a plugin source. */
+    text?: string;
+    /** The arg's declared `@type` (number, common_event, struct<X>, …), when scanned. */
+    type?: string;
+    /** The arg's `@default`, when scanned. */
+    default?: string;
+}
+/** Spec for one registered plugin command. */
+export interface PluginCommandSpec {
+    /** Display label the editor shows (parameters[2]); defaults to the command key. */
+    label?: string;
+    description?: string;
+    args?: PluginArgSpec[];
+}
+/** A plugin's registry entry: a description plus its known commands. */
+export interface PluginSpec {
+    description?: string;
+    commands: Record<string, PluginCommandSpec>;
+    /**
+     * Whether `js/plugins.js` has the plugin turned on. Only set by the project
+     * scanner — a built-in allowlist entry leaves it undefined (unknown), so only an
+     * explicit `false` is ever reported.
+     */
+    enabled?: boolean;
+}
+/** A plugin registry: plugin filename (no `.js`) → its spec. */
+export type PluginRegistry = Record<string, PluginSpec>;
+/**
+ * Curated allowlist of known community/official plugin commands, keyed by plugin
+ * filename → command key. Deliberately **not** exhaustive — it is a starter set
+ * meant to grow. Its only job is to turn a specific plugin command from opaque
+ * params into something `create_plugin_command` can validate (required args
+ * present, no stray args) and label the way the editor would. A plugin command
+ * that isn't listed here is still built fine — it just passes through with a soft
+ * "not in the allowlist" warning (warn-by-default, mirroring unknown event codes).
+ */
+export declare const PLUGIN_COMMAND_REGISTRY: PluginRegistry;
+/**
+ * Look up a plugin command spec, or `undefined` if the plugin/command is unlisted.
+ * `registry` defaults to the built-in allowlist; the tools pass a project-scanned
+ * registry merged over it (see `tools/pluginScanTools.ts`).
+ */
+export declare function lookupPluginCommand(pluginName: string, commandName: string, registry?: PluginRegistry): PluginCommandSpec | undefined;
+/**
+ * Normalize a plugin-command args object into the exact on-disk shape the editor
+ * writes: every value is a string. Scalars are stringified; objects/arrays (plugin
+ * "struct" params) are JSON-stringified into a single string. `null`/`undefined`
+ * values are dropped. A value that is already a string is left untouched (so a
+ * caller may pre-stringify a struct if they prefer).
+ */
+export declare function normalizePluginArgs(args: Record<string, unknown>): Record<string, string>;
+/**
+ * Validate a plugin command against the allowlist. Warn-by-default: an unlisted
+ * plugin or command yields a single soft warning (its args pass through
+ * unchecked); a listed command additionally flags missing required args and stray
+ * unknown args. Nothing throws.
+ */
+export declare function validatePluginCommand(pluginName: string, commandName: string, args: Record<string, unknown>, path?: string, registry?: PluginRegistry): ValidationWarning[];
+/**
+ * Build the plugin-command event command (code 357) for insertion into an event
+ * page via `add_event_command`. `label` defaults to the registry's display label
+ * (or the command key). Args are normalized to the editor's string-valued shape.
+ */
+export declare function buildPluginCommand(pluginName: string, commandName: string, args?: Record<string, unknown>, indent?: number, label?: string, registry?: PluginRegistry): EventCommand;
+//# sourceMappingURL=pluginCommands.d.ts.map

package/dist/validation/pluginCommands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluginCommands.d.ts","sourceRoot":"","sources":["../../src/validation/pluginCommands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEvD;;;;;;;;;GASG;AACH,eAAO,MAAM,mBAAmB,MAAM,CAAC;AAEvC,iDAAiD;AACjD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+EAA+E;IAC/E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qFAAqF;IACrF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,8CAA8C;AAC9C,MAAM,WAAW,iBAAiB;IAChC,mFAAmF;IACnF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,aAAa,EAAE,CAAC;CACxB;AAED,wEAAwE;AACxE,MAAM,WAAW,UAAU;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IAC5C;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,gEAAgE;AAChE,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAExD;;;;;;;;GAQG;AACH,eAAO,MAAM,uBAAuB,EAAE,cAiBrC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,QAAQ,GAAE,cAAwC,GACjD,iBAAiB,GAAG,SAAS,CAE/B;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOzF;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,IAAI,SAAiD,EACrD,QAAQ,GAAE,cAAwC,GACjD,iBAAiB,EAAE,CAyDrB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EAClC,MAAM,SAAI,EACV,KAAK,CAAC,EAAE,MAAM,EACd,QAAQ,GAAE,cAAwC,GACjD,YAAY,CAQd"}

package/dist/validation/pluginCommands.js

@@ -0,0 +1,134 @@
+/**
+ * Event command code for an RPG Maker MZ plugin command. On disk a 357 command is
+ * `{ code: 357, indent, parameters: [pluginName, commandName, label, args] }`:
+ *   - parameters[0] — plugin filename without `.js` (e.g. `TextPicture`)
+ *   - parameters[1] — the registered command key the plugin listens for
+ *   - parameters[2] — the editor's display label (cosmetic; the engine ignores it)
+ *   - parameters[3] — an args object `{ name: value }`; the editor stores every
+ *     value as a string (structs/arrays are JSON-stringified into that string).
+ * `command357` only reads [0], [1] and [3]; [2] is purely for the editor's list.
+ */
+export const PLUGIN_COMMAND_CODE = 357;
+/**
+ * Curated allowlist of known community/official plugin commands, keyed by plugin
+ * filename → command key. Deliberately **not** exhaustive — it is a starter set
+ * meant to grow. Its only job is to turn a specific plugin command from opaque
+ * params into something `create_plugin_command` can validate (required args
+ * present, no stray args) and label the way the editor would. A plugin command
+ * that isn't listed here is still built fine — it just passes through with a soft
+ * "not in the allowlist" warning (warn-by-default, mirroring unknown event codes).
+ */
+export const PLUGIN_COMMAND_REGISTRY = {
+    TextPicture: {
+        description: 'Official MZ sample plugin — render text as a picture.',
+        commands: {
+            set: {
+                label: 'Set text picture',
+                description: 'Set the text drawn by the next Show Picture command.',
+                args: [
+                    {
+                        name: 'text',
+                        required: true,
+                        description: 'The text to render (supports control characters like \\V[n]).',
+                    },
+                ],
+            },
+        },
+    },
+};
+/**
+ * Look up a plugin command spec, or `undefined` if the plugin/command is unlisted.
+ * `registry` defaults to the built-in allowlist; the tools pass a project-scanned
+ * registry merged over it (see `tools/pluginScanTools.ts`).
+ */
+export function lookupPluginCommand(pluginName, commandName, registry = PLUGIN_COMMAND_REGISTRY) {
+    return registry[pluginName]?.commands[commandName];
+}
+/**
+ * Normalize a plugin-command args object into the exact on-disk shape the editor
+ * writes: every value is a string. Scalars are stringified; objects/arrays (plugin
+ * "struct" params) are JSON-stringified into a single string. `null`/`undefined`
+ * values are dropped. A value that is already a string is left untouched (so a
+ * caller may pre-stringify a struct if they prefer).
+ */
+export function normalizePluginArgs(args) {
+    const out = {};
+    for (const [key, value] of Object.entries(args)) {
+        if (value === undefined || value === null)
+            continue;
+        out[key] = typeof value === 'object' ? JSON.stringify(value) : String(value);
+    }
+    return out;
+}
+/**
+ * Validate a plugin command against the allowlist. Warn-by-default: an unlisted
+ * plugin or command yields a single soft warning (its args pass through
+ * unchecked); a listed command additionally flags missing required args and stray
+ * unknown args. Nothing throws.
+ */
+export function validatePluginCommand(pluginName, commandName, args, path = `plugin command ${pluginName}: ${commandName}`, registry = PLUGIN_COMMAND_REGISTRY) {
+    const warnings = [];
+    const plugin = registry[pluginName];
+    if (!plugin) {
+        warnings.push({
+            path,
+            code: PLUGIN_COMMAND_CODE,
+            message: `plugin "${pluginName}" is not installed in this project and is not in the known-plugin allowlist (args passed through unchecked)`,
+        });
+        return warnings;
+    }
+    // A command on a plugin the editor has switched off never runs at all — a
+    // silent no-op that's easy to miss. Only the project scanner sets `enabled`.
+    if (plugin.enabled === false) {
+        warnings.push({
+            path,
+            code: PLUGIN_COMMAND_CODE,
+            message: `plugin "${pluginName}" is installed but disabled in js/plugins.js — this command will not run until it is enabled in the editor's Plugin Manager`,
+        });
+    }
+    const spec = plugin.commands[commandName];
+    if (!spec) {
+        warnings.push({
+            path,
+            code: PLUGIN_COMMAND_CODE,
+            message: `command "${commandName}" is not a known command of plugin "${pluginName}" (args passed through unchecked)`,
+        });
+        return warnings;
+    }
+    const known = spec.args ?? [];
+    const knownNames = new Set(known.map((a) => a.name));
+    for (const arg of known) {
+        if (arg.required && !(arg.name in args)) {
+            warnings.push({
+                path,
+                code: PLUGIN_COMMAND_CODE,
+                message: `missing required argument "${arg.name}"`,
+            });
+        }
+    }
+    for (const name of Object.keys(args)) {
+        if (!knownNames.has(name)) {
+            warnings.push({
+                path,
+                code: PLUGIN_COMMAND_CODE,
+                message: `unknown argument "${name}" for ${pluginName}: ${commandName}`,
+            });
+        }
+    }
+    return warnings;
+}
+/**
+ * Build the plugin-command event command (code 357) for insertion into an event
+ * page via `add_event_command`. `label` defaults to the registry's display label
+ * (or the command key). Args are normalized to the editor's string-valued shape.
+ */
+export function buildPluginCommand(pluginName, commandName, args = {}, indent = 0, label, registry = PLUGIN_COMMAND_REGISTRY) {
+    const spec = lookupPluginCommand(pluginName, commandName, registry);
+    const displayLabel = label ?? spec?.label ?? commandName;
+    return {
+        code: PLUGIN_COMMAND_CODE,
+        indent,
+        parameters: [pluginName, commandName, displayLabel, normalizePluginArgs(args)],
+    };
+}
+//# sourceMappingURL=pluginCommands.js.map

package/dist/validation/pluginCommands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluginCommands.js","sourceRoot":"","sources":["../../src/validation/pluginCommands.ts"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAsCvC;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAmB;IACrD,WAAW,EAAE;QACX,WAAW,EAAE,uDAAuD;QACpE,QAAQ,EAAE;YACR,GAAG,EAAE;gBACH,KAAK,EAAE,kBAAkB;gBACzB,WAAW,EAAE,sDAAsD;gBACnE,IAAI,EAAE;oBACJ;wBACE,IAAI,EAAE,MAAM;wBACZ,QAAQ,EAAE,IAAI;wBACd,WAAW,EAAE,+DAA+D;qBAC7E;iBACF;aACF;SACF;KACF;CACF,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CACjC,UAAkB,EAClB,WAAmB,EACnB,WAA2B,uBAAuB;IAElD,OAAO,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;AACrD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAA6B;IAC/D,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;YAAE,SAAS;QACpD,GAAG,CAAC,GAAG,CAAC,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC/E,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CACnC,UAAkB,EAClB,WAAmB,EACnB,IAA6B,EAC7B,IAAI,GAAG,kBAAkB,UAAU,KAAK,WAAW,EAAE,EACrD,WAA2B,uBAAuB;IAElD,MAAM,QAAQ,GAAwB,EAAE,CAAC;IAEzC,MAAM,MAAM,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;IACpC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI;YACJ,IAAI,EAAE,mBAAmB;YACzB,OAAO,EAAE,WAAW,UAAU,6GAA6G;SAC5I,CAAC,CAAC;QACH,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,0EAA0E;IAC1E,6EAA6E;IAC7E,IAAI,MAAM,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;QAC7B,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI;YACJ,IAAI,EAAE,mBAAmB;YACzB,OAAO,EAAE,WAAW,UAAU,6HAA6H;SAC5J,CAAC,CAAC;IACL,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC1C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI;YACJ,IAAI,EAAE,mBAAmB;YACzB,OAAO,EAAE,YAAY,WAAW,uCAAuC,UAAU,mCAAmC;SACrH,CAAC,CAAC;QACH,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;IAC9B,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAErD,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QACxB,IAAI,GAAG,CAAC,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,IAAI,IAAI,CAAC,EAAE,CAAC;YACxC,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI;gBACJ,IAAI,EAAE,mBAAmB;gBACzB,OAAO,EAAE,8BAA8B,GAAG,CAAC,IAAI,GAAG;aACnD,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACrC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI;gBACJ,IAAI,EAAE,mBAAmB;gBACzB,OAAO,EAAE,qBAAqB,IAAI,SAAS,UAAU,KAAK,WAAW,EAAE;aACxE,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAChC,UAAkB,EAClB,WAAmB,EACnB,OAAgC,EAAE,EAClC,MAAM,GAAG,CAAC,EACV,KAAc,EACd,WAA2B,uBAAuB;IAElD,MAAM,IAAI,GAAG,mBAAmB,CAAC,UAAU,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;IACpE,MAAM,YAAY,GAAG,KAAK,IAAI,IAAI,EAAE,KAAK,IAAI,WAAW,CAAC;IACzD,OAAO;QACL,IAAI,EAAE,mBAAmB;QACzB,MAAM;QACN,UAAU,EAAE,CAAC,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,mBAAmB,CAAC,IAAI,CAAC,CAAC;KAC/E,CAAC;AACJ,CAAC"}

package/dist/validation/pluginManifest.d.ts

@@ -0,0 +1,67 @@
+import { PluginRegistry, PluginSpec } from './pluginCommands.js';
+/**
+ * Parsers for what an RPG Maker MZ project already tells us about its plugins —
+ * the annotation comment block every plugin carries, and the `js/plugins.js`
+ * manifest the editor generates. Pure (no I/O) so they can be unit-tested against
+ * real plugin sources; the file reading lives in `tools/pluginScanTools.ts`.
+ *
+ * This is what turns plugin validation from a hand-maintained allowlist into real
+ * per-project coverage: the plugin sources ARE the source of truth for which
+ * commands exist and what args they take.
+ */
+/** One entry of the `$plugins` array in `js/plugins.js`. */
+export interface PluginManifestEntry {
+    name: string;
+    status: boolean;
+    description?: string;
+}
+/**
+ * Parse `js/plugins.js` — the editor-generated manifest listing which plugins are
+ * installed and whether each is **enabled** (`status`). The file is JS
+ * (`var $plugins = [ ... ];`) but the array literal itself is JSON, so it's
+ * extracted and parsed directly. Fails soft: anything unparseable yields `[]`.
+ */
+export declare function parsePluginsJs(source: string): PluginManifestEntry[];
+/**
+ * Extract the body of a plugin's **default-locale** annotation block.
+ *
+ * A plugin's metadata lives in a `/*:` comment. Localized copies of the same block
+ * are tagged (`/*:ja`) and must be skipped — otherwise a Japanese `@text` would win
+ * on the official sample plugins, which ship both. Struct definitions
+ * (`/*~struct~Name:`) are a different construct and are never matched here.
+ *
+ * Returns the block's inner text (comment markers still attached), or `null`.
+ */
+export declare function defaultAnnotationBlock(source: string): string | null;
+/**
+ * Parse a plugin's source into the same {@link PluginSpec} shape the built-in
+ * allowlist uses, reading its `@plugindesc`, `@command`s and their `@arg`s.
+ *
+ * Annotation grammar (from the official MZ sample plugins): `@command <key>` opens
+ * a command; `@arg <name>` opens an argument **of the command above it**; `@text`
+ * and `@desc` describe whichever of those is currently open. `@param` (a plugin
+ * *parameter*, not a command arg) and `@help` close that scope so their own
+ * `@text`/`@desc` don't attach to the last command.
+ *
+ * **No `required` is ever set:** MZ has no "required argument" annotation, so
+ * inferring it (e.g. from a missing `@default`) would only produce false "missing
+ * required argument" warnings. Scanned args are validated for *unknown* names only.
+ *
+ * Returns `null` when the source has no default-locale annotation block.
+ */
+export declare function parsePluginAnnotations(source: string): PluginSpec | null;
+/**
+ * Merge a project scan over the curated allowlist.
+ *
+ * The two registries know different things and neither is a superset:
+ * - the **scan** is authoritative on *structure* — which plugins/commands/args
+ *   actually exist in this project, and each arg's `@type`/`@default`;
+ * - the **allowlist** carries knowledge the annotations can't express, above all
+ *   `required` (MZ has no required-arg annotation).
+ *
+ * So the scan wins on structure while a curated `required`/`description` is carried
+ * across onto the matching arg by name, rather than a whole-plugin overwrite that
+ * would silently drop it.
+ */
+export declare function mergePluginRegistries(builtin: PluginRegistry, scanned: PluginRegistry): PluginRegistry;
+//# sourceMappingURL=pluginManifest.d.ts.map

package/dist/validation/pluginManifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluginManifest.d.ts","sourceRoot":"","sources":["../../src/validation/pluginManifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,cAAc,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEnG;;;;;;;;;GASG;AAEH,4DAA4D;AAC5D,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,mBAAmB,EAAE,CAmBpE;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQpE;AAgBD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAwExE;AAQD;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,cAAc,GACtB,cAAc,CAwBhB"}

package/dist/validation/pluginManifest.js

@@ -0,0 +1,199 @@
+/**
+ * Parse `js/plugins.js` — the editor-generated manifest listing which plugins are
+ * installed and whether each is **enabled** (`status`). The file is JS
+ * (`var $plugins = [ ... ];`) but the array literal itself is JSON, so it's
+ * extracted and parsed directly. Fails soft: anything unparseable yields `[]`.
+ */
+export function parsePluginsJs(source) {
+    const start = source.indexOf('[');
+    const end = source.lastIndexOf(']');
+    if (start === -1 || end === -1 || end < start)
+        return [];
+    try {
+        const parsed = JSON.parse(source.slice(start, end + 1));
+        if (!Array.isArray(parsed))
+            return [];
+        return parsed
+            .filter((entry) => !!entry && typeof entry === 'object')
+            .filter((entry) => typeof entry.name === 'string')
+            .map((entry) => ({
+            name: entry.name,
+            status: entry.status === true,
+            ...(typeof entry.description === 'string' ? { description: entry.description } : {}),
+        }));
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Extract the body of a plugin's **default-locale** annotation block.
+ *
+ * A plugin's metadata lives in a `/*:` comment. Localized copies of the same block
+ * are tagged (`/*:ja`) and must be skipped — otherwise a Japanese `@text` would win
+ * on the official sample plugins, which ship both. Struct definitions
+ * (`/*~struct~Name:`) are a different construct and are never matched here.
+ *
+ * Returns the block's inner text (comment markers still attached), or `null`.
+ */
+export function defaultAnnotationBlock(source) {
+    // Block opener + an optional locale tag + newline, up to the comment terminator.
+    const re = /\/\*:([A-Za-z_-]*)[ \t]*\r?\n([\s\S]*?)\*\//g;
+    let match;
+    while ((match = re.exec(source)) !== null) {
+        if (match[1] === '')
+            return match[2];
+    }
+    return null;
+}
+/** Strip the leading ` * ` comment gutter from an annotation-block line. */
+function stripGutter(line) {
+    return line.replace(/^[ \t]*\*[ \t]?/, '');
+}
+/**
+ * Parse a plugin's source into the same {@link PluginSpec} shape the built-in
+ * allowlist uses, reading its `@plugindesc`, `@command`s and their `@arg`s.
+ *
+ * Annotation grammar (from the official MZ sample plugins): `@command <key>` opens
+ * a command; `@arg <name>` opens an argument **of the command above it**; `@text`
+ * and `@desc` describe whichever of those is currently open. `@param` (a plugin
+ * *parameter*, not a command arg) and `@help` close that scope so their own
+ * `@text`/`@desc` don't attach to the last command.
+ *
+ * **No `required` is ever set:** MZ has no "required argument" annotation, so
+ * inferring it (e.g. from a missing `@default`) would only produce false "missing
+ * required argument" warnings. Scanned args are validated for *unknown* names only.
+ *
+ * Returns `null` when the source has no default-locale annotation block.
+ */
+export function parsePluginAnnotations(source) {
+    const block = defaultAnnotationBlock(source);
+    if (block === null)
+        return null;
+    const spec = { commands: {} };
+    let context = { kind: 'plugin' };
+    for (const raw of block.split(/\r?\n/)) {
+        const line = stripGutter(raw);
+        const match = /^@(\w+)[ \t]*(.*)$/.exec(line);
+        if (!match)
+            continue;
+        const [, tag, value] = match;
+        const trimmed = value.trim();
+        switch (tag) {
+            case 'plugindesc':
+                if (trimmed)
+                    spec.description = trimmed;
+                context = { kind: 'plugin' };
+                break;
+            case 'command': {
+                if (!trimmed)
+                    break;
+                const command = {};
+                spec.commands[trimmed] = command;
+                context = { kind: 'command', command };
+                break;
+            }
+            case 'arg': {
+                if (!trimmed || context.kind === 'plugin' || context.kind === 'other')
+                    break;
+                // An `@arg` belongs to the command above it — which, when the previous
+                // context was itself an arg, is still the same command.
+                const command = context.kind === 'command' ? context.command : lastCommand(spec);
+                if (!command)
+                    break;
+                const arg = { name: trimmed };
+                command.args = [...(command.args ?? []), arg];
+                context = { kind: 'arg', arg };
+                break;
+            }
+            case 'text':
+                if (context.kind === 'command')
+                    context.command.label = trimmed || undefined;
+                else if (context.kind === 'arg')
+                    context.arg.text = trimmed || undefined;
+                break;
+            case 'desc':
+                if (context.kind === 'command')
+                    context.command.description = trimmed || undefined;
+                else if (context.kind === 'arg')
+                    context.arg.description = trimmed || undefined;
+                break;
+            case 'type':
+                if (context.kind === 'arg')
+                    context.arg.type = trimmed || undefined;
+                break;
+            case 'default':
+                if (context.kind === 'arg')
+                    context.arg.default = trimmed;
+                break;
+            case 'param':
+            case 'help':
+                context = { kind: 'other' };
+                break;
+            default:
+                // Any other annotation (@target, @author, @url, @min, @max, @require, …)
+                // leaves the current scope open — @min/@max sit inside an @arg.
+                break;
+        }
+    }
+    return spec;
+}
+/** The most recently declared command, so a run of `@arg`s keeps attaching to it. */
+function lastCommand(spec) {
+    const keys = Object.keys(spec.commands);
+    return keys.length > 0 ? spec.commands[keys[keys.length - 1]] : undefined;
+}
+/**
+ * Merge a project scan over the curated allowlist.
+ *
+ * The two registries know different things and neither is a superset:
+ * - the **scan** is authoritative on *structure* — which plugins/commands/args
+ *   actually exist in this project, and each arg's `@type`/`@default`;
+ * - the **allowlist** carries knowledge the annotations can't express, above all
+ *   `required` (MZ has no required-arg annotation).
+ *
+ * So the scan wins on structure while a curated `required`/`description` is carried
+ * across onto the matching arg by name, rather than a whole-plugin overwrite that
+ * would silently drop it.
+ */
+export function mergePluginRegistries(builtin, scanned) {
+    const merged = { ...builtin };
+    for (const [name, scan] of Object.entries(scanned)) {
+        const base = builtin[name];
+        if (!base) {
+            merged[name] = scan;
+            continue;
+        }
+        const commands = { ...base.commands };
+        for (const [key, scanCommand] of Object.entries(scan.commands)) {
+            const baseCommand = base.commands[key];
+            commands[key] = baseCommand ? mergeCommand(baseCommand, scanCommand) : scanCommand;
+        }
+        merged[name] = {
+            ...base,
+            ...scan,
+            commands,
+        };
+    }
+    return merged;
+}
+function mergeCommand(base, scan) {
+    return {
+        label: scan.label ?? base.label,
+        description: scan.description ?? base.description,
+        // A scan that found no args at all tells us nothing about them, so the
+        // curated list survives; otherwise the scanned list is the real one.
+        args: scan.args ? scan.args.map((arg) => mergeArg(base.args ?? [], arg)) : base.args,
+    };
+}
+function mergeArg(baseArgs, scan) {
+    const base = baseArgs.find((a) => a.name === scan.name);
+    if (!base)
+        return scan;
+    return {
+        ...scan,
+        ...(base.required !== undefined ? { required: base.required } : {}),
+        description: scan.description ?? base.description,
+    };
+}
+//# sourceMappingURL=pluginManifest.js.map

package/dist/validation/pluginManifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluginManifest.js","sourceRoot":"","sources":["../../src/validation/pluginManifest.ts"],"names":[],"mappings":"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"}

package/dist/validation/references.d.ts

@@ -0,0 +1,57 @@
+import { Actor, GameClass, Skill, Item, Weapon, Armor, Enemy, Troop, State, CommonEvent, MapEvent, MapInfo, SystemData } from '../utils/types.js';
+/**
+ * A single cross-file reference-integrity finding. Like {@link
+ * ValidationWarning} this is warn-by-default (it never blocks a write); it tells
+ * the caller that one record points at another record that doesn't exist — a
+ * dangling id the RPG Maker editor would silently treat as "nothing", producing
+ * a subtle runtime bug rather than an error. `category` groups findings by the
+ * kind of reference; `path` locates the offending field.
+ */
+export interface ReferenceWarning {
+    category: string;
+    path: string;
+    message: string;
+}
+/**
+ * The loaded project data the reference linter cross-checks. Every database
+ * array is the raw 1-indexed file (slot 0 `null`). `animations` is `null` when
+ * `Animations.json` couldn't be loaded, so animation-id checks are skipped
+ * rather than flagging every reference. Kept as plain data so {@link
+ * checkReferences} stays pure and unit-testable without file I/O.
+ */
+export interface ProjectData {
+    mapInfos: (MapInfo | null)[];
+    /** Only the maps that loaded, carrying just the id + events the linter needs. */
+    maps: Array<{
+        id: number;
+        events: (MapEvent | null)[];
+    }>;
+    actors: (Actor | null)[];
+    classes: (GameClass | null)[];
+    skills: (Skill | null)[];
+    items: (Item | null)[];
+    weapons: (Weapon | null)[];
+    armors: (Armor | null)[];
+    enemies: (Enemy | null)[];
+    troops: (Troop | null)[];
+    states: (State | null)[];
+    commonEvents: (CommonEvent | null)[];
+    /** `null` = Animations.json unavailable → animation-id checks skipped. */
+    animations: (unknown | null)[] | null;
+    system: SystemData | null;
+}
+/**
+ * Whether `id` names a live entry in a 1-indexed RPG Maker database array (slot
+ * 0 is `null`; id === array index). A `0`/negative id, an out-of-range id, or a
+ * nulled slot all count as "does not exist". An empty array (a file that failed
+ * to load) is treated as "can't verify" — never a match, but callers guard on
+ * array length so a failed load doesn't flag every reference.
+ */
+export declare function refExists(arr: readonly (unknown | null)[], id: number): boolean;
+/**
+ * Run every cross-file reference check over a loaded project snapshot. Pure and
+ * warn-by-default: returns an aggregated list of dangling/cyclic references,
+ * empty when everything resolves. See {@link ProjectData} for the input shape.
+ */
+export declare function checkReferences(data: ProjectData): ReferenceWarning[];
+//# sourceMappingURL=references.d.ts.map

package/dist/validation/references.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"references.d.ts","sourceRoot":"","sources":["../../src/validation/references.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,EACL,SAAS,EACT,KAAK,EACL,IAAI,EACJ,MAAM,EACN,KAAK,EACL,KAAK,EACL,KAAK,EACL,KAAK,EACL,WAAW,EACX,QAAQ,EACR,OAAO,EACP,UAAU,EAEX,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,CAAC,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC;IAC7B,iFAAiF;IACjF,IAAI,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,CAAC,QAAQ,GAAG,IAAI,CAAC,EAAE,CAAA;KAAE,CAAC,CAAC;IACzD,MAAM,EAAE,CAAC,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC;IACzB,OAAO,EAAE,CAAC,SAAS,GAAG,IAAI,CAAC,EAAE,CAAC;IAC9B,MAAM,EAAE,CAAC,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC;IACzB,KAAK,EAAE,CAAC,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;IACvB,OAAO,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;IAC3B,MAAM,EAAE,CAAC,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC;IACzB,OAAO,EAAE,CAAC,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC;IAC1B,MAAM,EAAE,CAAC,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC;IACzB,MAAM,EAAE,CAAC,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC;IACzB,YAAY,EAAE,CAAC,WAAW,GAAG,IAAI,CAAC,EAAE,CAAC;IACrC,0EAA0E;IAC1E,UAAU,EAAE,CAAC,OAAO,GAAG,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC;IACtC,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;CAC3B;AAYD;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC,EAAE,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAE/E;AA6TD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,WAAW,GAAG,gBAAgB,EAAE,CASrE"}