rpgmaker-mz-mcp 1.0.0

package/dist/tools/systemTools.d.ts

@@ -0,0 +1,86 @@
+import { SystemData, Terms } from '../utils/types.js';
+import { ToolDefinition } from '../registry.js';
+/**
+ * Get system data
+ */
+export declare function getSystem(projectPath: string): Promise<SystemData>;
+/**
+ * Update system data
+ */
+export declare function updateSystem(projectPath: string, updates: Partial<SystemData>): Promise<SystemData>;
+/**
+ * Get game variables
+ */
+export declare function getVariables(projectPath: string): Promise<string[]>;
+/**
+ * Set a variable name
+ */
+export declare function setVariableName(projectPath: string, variableId: number, name: string): Promise<void>;
+/**
+ * Get game switches
+ */
+export declare function getSwitches(projectPath: string): Promise<string[]>;
+/**
+ * Set a switch name
+ */
+export declare function setSwitchName(projectPath: string, switchId: number, name: string): Promise<void>;
+/**
+ * Get party members
+ */
+export declare function getPartyMembers(projectPath: string): Promise<number[]>;
+/**
+ * Update the starting party (the actor ids the game begins with). Validates every
+ * id references an existing actor (throws otherwise — mirrors create_map's parent
+ * check) so a bad party can't silently break new-game setup.
+ */
+export declare function updatePartyMembers(projectPath: string, partyMembers: number[]): Promise<void>;
+/**
+ * Get starting position
+ */
+export declare function getStartingPosition(projectPath: string): Promise<{
+    mapId: number;
+    x: number;
+    y: number;
+}>;
+/**
+ * Update starting position. Validates the map exists (in MapInfos) and that x/y
+ * fall within that map's bounds — consistent with set_party's actor-id check and
+ * set_encounters' troop check, so a typo can't point new-game at a missing map or
+ * an off-map tile.
+ */
+export declare function updateStartingPosition(projectPath: string, mapId: number, x: number, y: number): Promise<void>;
+/**
+ * Get game title
+ */
+export declare function getGameTitle(projectPath: string): Promise<string>;
+/**
+ * Update game title
+ */
+export declare function updateGameTitle(projectPath: string, title: string): Promise<void>;
+/**
+ * Get all terms (vocabulary): the `basic`, `commands`, `params` string arrays
+ * and the `messages` string map.
+ */
+export declare function getTerms(projectPath: string): Promise<Terms>;
+/** The four vocabulary categories in System.json's `terms`. */
+export type TermCategory = 'basic' | 'commands' | 'params' | 'messages';
+/**
+ * Set one vocabulary term. For `basic`/`commands`/`params` the `key` is a numeric
+ * index (passed as a string); for `messages` it's a string message key. Throws on
+ * an out-of-range index (so a typo can't silently grow a sparse array).
+ */
+export declare function setTerm(projectPath: string, category: TermCategory, key: string, value: string): Promise<Terms>;
+/** The System.json "type name" arrays other data references by index. */
+export type TypeCategory = 'elements' | 'skillTypes' | 'weaponTypes' | 'armorTypes' | 'equipTypes';
+/** Get one type-name array (elements, skillTypes, weaponTypes, armorTypes, equipTypes). */
+export declare function getTypes(projectPath: string, category: TypeCategory): Promise<string[]>;
+/**
+ * Rename one entry in a type-name array. `index` 0 is the conventional empty slot
+ * (kept as `""` by the editor). Throws on an out-of-range index rather than
+ * growing the array with holes.
+ */
+export declare function setTypeName(projectPath: string, category: TypeCategory, index: number, name: string): Promise<string[]>;
+/** Set the currency unit shown next to gold amounts (e.g. "G"). */
+export declare function setCurrencyUnit(projectPath: string, unit: string): Promise<void>;
+export declare const systemToolDefinitions: ToolDefinition[];
+//# sourceMappingURL=systemTools.d.ts.map

package/dist/tools/systemTools.d.ts.map

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

package/dist/tools/systemTools.js

@@ -0,0 +1,342 @@
+import { z } from 'zod';
+import { readJsonFile, readJsonArraySoft, getDataPath, getMapPath } from '../utils/fileHandler.js';
+import { commitChange } from '../utils/commit.js';
+/**
+ * Get system data
+ */
+export async function getSystem(projectPath) {
+    const systemPath = getDataPath(projectPath, 'System.json');
+    return await readJsonFile(systemPath);
+}
+/**
+ * Update system data
+ */
+export async function updateSystem(projectPath, updates) {
+    const system = await getSystem(projectPath);
+    const updatedSystem = { ...system, ...updates };
+    const systemPath = getDataPath(projectPath, 'System.json');
+    await commitChange(systemPath, updatedSystem);
+    return updatedSystem;
+}
+/**
+ * Get game variables
+ */
+export async function getVariables(projectPath) {
+    const system = await getSystem(projectPath);
+    return system.variables;
+}
+/**
+ * Set a variable name
+ */
+export async function setVariableName(projectPath, variableId, name) {
+    const system = await getSystem(projectPath);
+    if (variableId < 1 || variableId >= system.variables.length) {
+        throw new Error(`Variable id ${variableId} is out of range (project has ${system.variables.length - 1} variables). Add more in the editor's Database > System first.`);
+    }
+    system.variables[variableId] = name;
+    const systemPath = getDataPath(projectPath, 'System.json');
+    await commitChange(systemPath, system);
+}
+/**
+ * Get game switches
+ */
+export async function getSwitches(projectPath) {
+    const system = await getSystem(projectPath);
+    return system.switches;
+}
+/**
+ * Set a switch name
+ */
+export async function setSwitchName(projectPath, switchId, name) {
+    const system = await getSystem(projectPath);
+    if (switchId < 1 || switchId >= system.switches.length) {
+        throw new Error(`Switch id ${switchId} is out of range (project has ${system.switches.length - 1} switches). Add more in the editor's Database > System first.`);
+    }
+    system.switches[switchId] = name;
+    const systemPath = getDataPath(projectPath, 'System.json');
+    await commitChange(systemPath, system);
+}
+/**
+ * Get party members
+ */
+export async function getPartyMembers(projectPath) {
+    const system = await getSystem(projectPath);
+    return system.partyMembers;
+}
+/**
+ * Update the starting party (the actor ids the game begins with). Validates every
+ * id references an existing actor (throws otherwise — mirrors create_map's parent
+ * check) so a bad party can't silently break new-game setup.
+ */
+export async function updatePartyMembers(projectPath, partyMembers) {
+    const actors = await readJsonFile(getDataPath(projectPath, 'Actors.json'));
+    for (const id of partyMembers) {
+        if (!actors[id]) {
+            throw new Error(`Party member actor id ${id} does not exist in Actors.json`);
+        }
+    }
+    const system = await getSystem(projectPath);
+    system.partyMembers = partyMembers;
+    const systemPath = getDataPath(projectPath, 'System.json');
+    await commitChange(systemPath, system);
+}
+/**
+ * Get starting position
+ */
+export async function getStartingPosition(projectPath) {
+    const system = await getSystem(projectPath);
+    return {
+        mapId: system.startMapId,
+        x: system.startX,
+        y: system.startY,
+    };
+}
+/**
+ * Update starting position. Validates the map exists (in MapInfos) and that x/y
+ * fall within that map's bounds — consistent with set_party's actor-id check and
+ * set_encounters' troop check, so a typo can't point new-game at a missing map or
+ * an off-map tile.
+ */
+export async function updateStartingPosition(projectPath, mapId, x, y) {
+    const mapInfos = await readJsonArraySoft(getDataPath(projectPath, 'MapInfos.json'));
+    if (!mapInfos[mapId]) {
+        throw new Error(`Starting map id ${mapId} does not exist in MapInfos.json`);
+    }
+    const map = await readJsonFile(getMapPath(projectPath, mapId));
+    if (x < 0 || x >= map.width || y < 0 || y >= map.height) {
+        throw new Error(`Starting position (${x}, ${y}) is out of bounds for map ${mapId} (${map.width}x${map.height})`);
+    }
+    const system = await getSystem(projectPath);
+    system.startMapId = mapId;
+    system.startX = x;
+    system.startY = y;
+    const systemPath = getDataPath(projectPath, 'System.json');
+    await commitChange(systemPath, system);
+}
+/**
+ * Get game title
+ */
+export async function getGameTitle(projectPath) {
+    const system = await getSystem(projectPath);
+    return system.gameTitle;
+}
+/**
+ * Update game title
+ */
+export async function updateGameTitle(projectPath, title) {
+    const system = await getSystem(projectPath);
+    system.gameTitle = title;
+    const systemPath = getDataPath(projectPath, 'System.json');
+    await commitChange(systemPath, system);
+}
+/**
+ * Get all terms (vocabulary): the `basic`, `commands`, `params` string arrays
+ * and the `messages` string map.
+ */
+export async function getTerms(projectPath) {
+    const system = await getSystem(projectPath);
+    return system.terms;
+}
+/**
+ * Set one vocabulary term. For `basic`/`commands`/`params` the `key` is a numeric
+ * index (passed as a string); for `messages` it's a string message key. Throws on
+ * an out-of-range index (so a typo can't silently grow a sparse array).
+ */
+export async function setTerm(projectPath, category, key, value) {
+    const system = await getSystem(projectPath);
+    const terms = system.terms;
+    if (category === 'messages') {
+        terms.messages[key] = value;
+    }
+    else {
+        const index = Number(key);
+        const arr = terms[category];
+        if (!Number.isInteger(index) || index < 0 || index >= arr.length) {
+            throw new Error(`terms.${category} index ${key} is out of range (0..${arr.length - 1})`);
+        }
+        arr[index] = value;
+    }
+    await commitChange(getDataPath(projectPath, 'System.json'), system);
+    return terms;
+}
+/** Get one type-name array (elements, skillTypes, weaponTypes, armorTypes, equipTypes). */
+export async function getTypes(projectPath, category) {
+    const system = await getSystem(projectPath);
+    return system[category];
+}
+/**
+ * Rename one entry in a type-name array. `index` 0 is the conventional empty slot
+ * (kept as `""` by the editor). Throws on an out-of-range index rather than
+ * growing the array with holes.
+ */
+export async function setTypeName(projectPath, category, index, name) {
+    const system = await getSystem(projectPath);
+    const arr = system[category];
+    if (!Number.isInteger(index) || index < 0 || index >= arr.length) {
+        throw new Error(`${category} index ${index} is out of range (0..${arr.length - 1})`);
+    }
+    arr[index] = name;
+    await commitChange(getDataPath(projectPath, 'System.json'), system);
+    return arr;
+}
+/** Set the currency unit shown next to gold amounts (e.g. "G"). */
+export async function setCurrencyUnit(projectPath, unit) {
+    const system = await getSystem(projectPath);
+    system.currencyUnit = unit;
+    await commitChange(getDataPath(projectPath, 'System.json'), system);
+}
+export const systemToolDefinitions = [
+    {
+        name: 'get_system',
+        description: 'Get system data',
+        inputSchema: {},
+        handler: (ctx) => getSystem(ctx.projectPath),
+    },
+    {
+        name: 'get_variables',
+        description: 'Get all game variable names',
+        inputSchema: {},
+        handler: (ctx) => getVariables(ctx.projectPath),
+    },
+    {
+        name: 'set_variable_name',
+        mutates: true,
+        description: 'Set a variable name',
+        inputSchema: {
+            variableId: z.number().int().positive().describe('The 1-based variable ID'),
+            name: z.string().describe('The name to assign'),
+        },
+        handler: async (ctx, args) => {
+            await setVariableName(ctx.projectPath, args.variableId, args.name);
+            return { success: true };
+        },
+    },
+    {
+        name: 'get_switches',
+        description: 'Get all game switch names',
+        inputSchema: {},
+        handler: (ctx) => getSwitches(ctx.projectPath),
+    },
+    {
+        name: 'set_switch_name',
+        mutates: true,
+        description: 'Set a switch name',
+        inputSchema: {
+            switchId: z.number().int().positive().describe('The 1-based switch ID'),
+            name: z.string().describe('The name to assign'),
+        },
+        handler: async (ctx, args) => {
+            await setSwitchName(ctx.projectPath, args.switchId, args.name);
+            return { success: true };
+        },
+    },
+    {
+        name: 'get_game_title',
+        description: 'Get the game title',
+        inputSchema: {},
+        handler: (ctx) => getGameTitle(ctx.projectPath),
+    },
+    {
+        name: 'update_game_title',
+        mutates: true,
+        description: 'Update the game title',
+        inputSchema: { title: z.string().describe('The new game title') },
+        handler: async (ctx, args) => {
+            await updateGameTitle(ctx.projectPath, args.title);
+            return { success: true };
+        },
+    },
+    {
+        name: 'get_starting_position',
+        description: 'Get the game starting position ({ mapId, x, y })',
+        inputSchema: {},
+        handler: (ctx) => getStartingPosition(ctx.projectPath),
+    },
+    {
+        name: 'update_starting_position',
+        mutates: true,
+        description: 'Update the game starting position',
+        inputSchema: {
+            mapId: z.number().int().positive().describe('Starting map ID'),
+            x: z.number().int().nonnegative().describe('Starting x tile'),
+            y: z.number().int().nonnegative().describe('Starting y tile'),
+        },
+        handler: async (ctx, args) => {
+            await updateStartingPosition(ctx.projectPath, args.mapId, args.x, args.y);
+            return { success: true };
+        },
+    },
+    {
+        name: 'get_party',
+        description: "Get the starting party — the actor ids the game begins with. Returns `{ partyMembers }`, rhyming with set_party's input/output shape.",
+        inputSchema: {},
+        handler: async (ctx) => ({ partyMembers: await getPartyMembers(ctx.projectPath) }),
+    },
+    {
+        name: 'set_party',
+        mutates: true,
+        description: 'Set the starting party (the actor ids the game begins with, in order). Every id must reference an existing actor.',
+        inputSchema: {
+            partyMembers: z
+                .array(z.number().int().positive())
+                .describe('Ordered actor ids for the starting party'),
+        },
+        handler: async (ctx, args) => {
+            await updatePartyMembers(ctx.projectPath, args.partyMembers);
+            return { success: true, partyMembers: args.partyMembers };
+        },
+    },
+    {
+        name: 'get_terms',
+        description: 'Get the game vocabulary/terms: the `basic`, `commands`, `params` string arrays and the `messages` map (menu labels, system messages).',
+        inputSchema: {},
+        handler: (ctx) => getTerms(ctx.projectPath),
+    },
+    {
+        name: 'set_term',
+        mutates: true,
+        description: "Set one vocabulary term. For category 'basic'/'commands'/'params' the key is a numeric index (as a string); for 'messages' it's a message key (e.g. 'actorDamage'). Returns the updated terms.",
+        inputSchema: {
+            category: z
+                .enum(['basic', 'commands', 'params', 'messages'])
+                .describe('Which term group to edit'),
+            key: z.string().describe('Index (for basic/commands/params) or message key (for messages)'),
+            value: z.string().describe('The new term text'),
+        },
+        handler: (ctx, args) => setTerm(ctx.projectPath, args.category, args.key, args.value),
+    },
+    {
+        name: 'get_types',
+        description: 'Get one System.json type-name array — the named lists other data references by index: elements, skillTypes, weaponTypes, armorTypes, or equipTypes.',
+        inputSchema: {
+            category: z
+                .enum(['elements', 'skillTypes', 'weaponTypes', 'armorTypes', 'equipTypes'])
+                .describe('Which type-name array to read'),
+        },
+        handler: (ctx, args) => getTypes(ctx.projectPath, args.category),
+    },
+    {
+        name: 'set_type_name',
+        mutates: true,
+        description: 'Rename one entry in a System.json type-name array (elements/skillTypes/weaponTypes/armorTypes/equipTypes). Index 0 is the conventional empty slot. Returns the updated array.',
+        inputSchema: {
+            category: z
+                .enum(['elements', 'skillTypes', 'weaponTypes', 'armorTypes', 'equipTypes'])
+                .describe('Which type-name array to edit'),
+            index: z.number().int().nonnegative().describe('Index within the array (0 = empty slot)'),
+            name: z.string().describe('The new type name'),
+        },
+        handler: (ctx, args) => setTypeName(ctx.projectPath, args.category, args.index, args.name),
+    },
+    {
+        name: 'set_currency_unit',
+        mutates: true,
+        description: 'Set the currency unit shown next to gold amounts (e.g. "G", "Gold").',
+        inputSchema: { unit: z.string().describe('The currency unit string') },
+        handler: async (ctx, args) => {
+            await setCurrencyUnit(ctx.projectPath, args.unit);
+            return { success: true, currencyUnit: args.unit };
+        },
+    },
+];
+//# sourceMappingURL=systemTools.js.map

package/dist/tools/systemTools.js.map

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

package/dist/tools/tileTools.d.ts

@@ -0,0 +1,9 @@
+import { ToolDefinition } from '../registry.js';
+/**
+ * Read-only tools over the tile-id codec. `describe_tile` turns an opaque raw
+ * tile integer into a legible {sheet, kind, shape, autotile geometry} view —
+ * the inspection counterpart to the low-level `set_map_tile` primitive, and the
+ * foothold for the semantic catalog and paint commands that follow.
+ */
+export declare const tileToolDefinitions: ToolDefinition[];
+//# sourceMappingURL=tileTools.d.ts.map

package/dist/tools/tileTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tileTools.d.ts","sourceRoot":"","sources":["../../src/tools/tileTools.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAKhD;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,EAAE,cAAc,EAsB/C,CAAC"}

package/dist/tools/tileTools.js

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+import { decodeTile } from '../tiles/tileCodec.js';
+import { getTileset } from './tilesetTools.js';
+import { tileTransparencyDetail } from './tileTransparency.js';
+/**
+ * Read-only tools over the tile-id codec. `describe_tile` turns an opaque raw
+ * tile integer into a legible {sheet, kind, shape, autotile geometry} view —
+ * the inspection counterpart to the low-level `set_map_tile` primitive, and the
+ * foothold for the semantic catalog and paint commands that follow.
+ */
+export const tileToolDefinitions = [
+    {
+        name: 'describe_tile',
+        description: 'Decode a raw RPG Maker MZ tile id into its tileset sheet (A1–A5, B–E), and for autotiles its kind + shape slot (0–47) and autotile geometry (floor/wall/waterfall). Read-only inspection helper — raw tile ids are opaque integers, this makes one legible. Returns { tileId, empty, sheet, sheetIndex, autotile, kind?, shape?, autotileType? }. Pass `tilesetId` to also inspect the sheet PNG and report `transparent` (true = the tile is see-through and needs an opaque base tile on a lower layer; painting it on layer 0 alone shows the map void) + `transparentPercent`.',
+        inputSchema: {
+            tileId: z.number().int().nonnegative().describe('The raw tile id to decode'),
+            tilesetId: z
+                .number()
+                .int()
+                .positive()
+                .optional()
+                .describe('Tileset id — when given, also report the tile transparency (needs-a-base) flag'),
+        },
+        handler: async (ctx, args) => {
+            const decoded = decodeTile(args.tileId);
+            if (args.tilesetId === undefined)
+                return decoded;
+            const tileset = await getTileset(ctx.projectPath, args.tilesetId);
+            const detail = await tileTransparencyDetail(ctx.projectPath, tileset, args.tileId);
+            return detail ? { ...decoded, ...detail } : decoded;
+        },
+    },
+];
+//# sourceMappingURL=tileTools.js.map

package/dist/tools/tileTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tileTools.js","sourceRoot":"","sources":["../../src/tools/tileTools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAE/D;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAqB;IACnD;QACE,IAAI,EAAE,eAAe;QACrB,WAAW,EACT,ojBAAojB;QACtjB,WAAW,EAAE;YACX,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,2BAA2B,CAAC;YAC5E,SAAS,EAAE,CAAC;iBACT,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,QAAQ,EAAE;iBACV,QAAQ,EAAE;iBACV,QAAQ,CAAC,gFAAgF,CAAC;SAC9F;QACD,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;YAC3B,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACxC,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS;gBAAE,OAAO,OAAO,CAAC;YACjD,MAAM,OAAO,GAAG,MAAM,UAAU,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;YAClE,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YACnF,OAAO,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;QACtD,CAAC;KACF;CACF,CAAC"}

package/dist/tools/tileTransparency.d.ts

@@ -0,0 +1,40 @@
+import { MapData, Tileset } from '../utils/types.js';
+import { CatalogEntry } from '../tiles/catalog/index.js';
+/**
+ * Whether a raw tile id is transparent enough to need an opaque base beneath it.
+ * `undefined` = unknown (empty tile, or the sheet PNG couldn't be read). A small
+ * `cache` map memoises results within one operation so a big fill doesn't
+ * reclassify the same id repeatedly.
+ */
+export declare function isTileTransparent(projectPath: string, tileset: Tileset, tileId: number, cache?: Map<number, boolean | undefined>): Promise<boolean | undefined>;
+/**
+ * The transparency reading for one tile: whether it needs a base and the percent
+ * of its sample that is transparent (for `describe_tile`). `undefined` when the
+ * tile is empty or the sheet PNG can't be read.
+ */
+export declare function tileTransparencyDetail(projectPath: string, tileset: Tileset, tileId: number): Promise<{
+    transparent: boolean;
+    transparentPercent: number;
+} | undefined>;
+/**
+ * Set each catalog entry's `transparent` flag by inspecting its tileset sheet
+ * (in place). Entries whose sheet PNG can't be read are left unset (unknown).
+ * Only worth calling on a bounded entry list (one sheet, or `find_tile` matches).
+ */
+export declare function annotateTransparency(projectPath: string, tileset: Tileset, entries: CatalogEntry[]): Promise<void>;
+/** A cell paint plus the layer it landed on — the input to the base-aware scan. */
+export interface PaintedCell {
+    x: number;
+    y: number;
+    tileId: number;
+    layer: number;
+}
+/**
+ * Scan painted cells for the transparent-tile-without-a-base footgun: a
+ * transparent tile on layer L with no *opaque* tile on any lower layer in the
+ * same cell will show the map's void through its see-through areas. Returns a
+ * single aggregated warning (or `undefined`) so a large fill doesn't spam one
+ * line per cell. Fails soft — cells whose transparency can't be read are ignored.
+ */
+export declare function baseAwareTransparencyWarning(projectPath: string, map: MapData, tileset: Tileset, cells: PaintedCell[]): Promise<string | undefined>;
+//# sourceMappingURL=tileTransparency.d.ts.map

package/dist/tools/tileTransparency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tileTransparency.d.ts","sourceRoot":"","sources":["../../src/tools/tileTransparency.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AA0DzD;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,CAAC,GACvC,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAK9B;AAUD;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;IAAE,WAAW,EAAE,OAAO,CAAC;IAAC,kBAAkB,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAAC,CAO3E;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,YAAY,EAAE,GACtB,OAAO,CAAC,IAAI,CAAC,CAMf;AAED,mFAAmF;AACnF,MAAM,WAAW,WAAW;IAC1B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;GAMG;AACH,wBAAsB,4BAA4B,CAChD,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,OAAO,EACZ,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,WAAW,EAAE,GACnB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAgC7B"}