@iborymagic/aseprite-mcp 0.4.4 → 0.4.6

package/build/lua/templates/auto_crop_transparent.lua

@@ -0,0 +1,23 @@
+-- Auto-crops a sprite and saves the result.
+-- Params:
+--   saveOutput  : string
+
+local p = app.params
+if not p or not p.saveOutput then
+  print("ERROR: saveOutput is required")
+  return
+end
+
+local sprite = app.activeSprite
+
+if not sprite then
+  print("ERROR: No active sprite")
+  return
+end
+
+app.command.AutocropSprite()
+
+sprite:saveAs(p.saveOutput)
+
+sprite:close()
+print("auto_crop_transparent script executed successfully")

package/build/lua/templates/export_layer_only.lua

@@ -0,0 +1,41 @@
+-- Exports a single layer as a PNG file.
+-- Params:
+--   layerName   : string
+--   outputDir   : string (must exist or will be created by Node side)
+
+local p = app.params
+if not p or not p.layerName or not p.outputDir then
+  print("ERROR: layerName and outputDir are required")
+  return
+end
+
+local sprite = app.activeSprite
+
+if not sprite then
+  print("ERROR: No active sprite")
+  return
+end
+
+local target = nil
+
+for _, layer in ipairs(sprite.layers) do
+  if layer.name == p.layerName then
+    target = layer
+  end
+end
+
+if not target then
+  print("ERROR: Layer not found: " .. p.layerName)
+  return
+end
+
+for _, layer in ipairs(sprite.layers) do
+  layer.isVisible = false
+end
+
+target.isVisible = true
+
+sprite:saveAs(p.outputDir .. "/" .. p.layerName .. ".png")
+
+sprite:close()
+print("export_layer_only script executed successfully")

package/build/lua/templates/export_tag_frames.lua

@@ -0,0 +1,67 @@
+-- Exports only frames inside a specific tag as individual PNG files.
+-- Params:
+--   tag            : string
+--   outputDir      : string (must exist or will be created by Node side)
+--   filenamePrefix : string (optional, default "frame")
+
+local p = app.params
+
+if not p or not p.outputDir then
+  print("ERROR: outputDir is required")
+  return
+end
+
+local sprite = app.activeSprite
+
+if not sprite then
+  print("ERROR: No active sprite")
+  return
+end
+
+local tagName = p.tag
+if not tagName or tagName == "" then
+  print("ERROR: tag is required")
+  return
+end
+
+local outputDir = p.outputDir or "."
+local prefix = p.filenamePrefix or "frame"
+
+local tag = nil
+for _, t in ipairs(sprite.tags) do
+  if t.name == tagName then
+    tag = t
+    break
+  end
+end
+
+if not tag then
+  print("ERROR: Tag not found: " .. tagName)
+  return
+end
+
+local startFrame = tag.fromFrame.frameNumber
+local endFrame = tag.toFrame.frameNumber
+
+for frameNumber = startFrame, endFrame do
+  local frameIndex = frameNumber - 1
+  
+  local newSprite = Sprite(sprite.spec)
+  for i, layer in ipairs(sprite.layers) do
+    if i > 1 then
+      newSprite:newLayer(layer.name)
+    end
+    
+    local cel = layer:cel(frameIndex)
+    if cel then
+      newSprite:newCel(newSprite.layers[i], newSprite.frames[1], cel.image, cel.position)
+    end
+  end
+  
+  local filename = string.format("%s/%s-%04d.png", outputDir, prefix, frameNumber)
+  newSprite:saveAs(filename)
+  newSprite:close()
+end
+
+sprite:close()
+print("export_tag_frames script executed successfully")

package/build/lua/templates/get_active_sprite_info.lua

@@ -0,0 +1,19 @@
+-- Returns information about the active sprite.
+-- Params:
+--   none
+
+local sprite = app.activeSprite
+
+if not sprite then
+  print("ERROR: No active sprite")
+  return
+end
+
+print(json.encode({
+  width = sprite.width,
+  height = sprite.height,
+  colorMode = sprite.colorMode == ColorMode.RGB and "rgb"
+           or sprite.colorMode == ColorMode.INDEXED and "indexed"
+           or "grayscale",
+  frameCount = #sprite.frames
+}))

package/build/lua/templates/get_frame_info.lua

@@ -0,0 +1,24 @@
+-- Returns information about the current frame.
+-- Params:
+--   none
+
+local sprite = app.activeSprite
+
+if not sprite then
+  print("ERROR: No active sprite")
+  return
+end
+
+local result = {
+  currentFrame = app.activeFrame.frameNumber,
+  frames = {}
+}
+
+for i, frame in ipairs(sprite.frames) do
+  table.insert(result.frames, {
+    index = i,
+    duration = frame.duration
+  })
+end
+
+print(json.encode(result))

package/build/lua/templates/get_is_layer_exists.lua

@@ -0,0 +1,33 @@
+-- Returns true if the layer exists in the active sprite.
+-- Params:
+--   layerName : string
+
+local p = app.params
+local sprite = app.activeSprite
+
+if not sprite then
+  print("ERROR: No active sprite")
+  return
+end
+
+if not p or not p.layerName then
+  print("ERROR: layerName is required")
+  return
+end
+
+local function getIsLayerExists(layers)
+  for _, layer in ipairs(layers) do
+    if layer.name == p.layerName then
+      print(true)
+      return
+    end
+    if layer.isGroup and getIsLayerExists(layer.layers) then
+      print(true)
+      return
+    end
+  end
+  print(false)
+  return
+end
+
+print(getIsLayerExists(sprite.layers))

package/build/lua/templates/get_is_tag_exists.lua

@@ -0,0 +1,25 @@
+-- Returns true if the tag exists in the active sprite.
+-- Params:
+--   tagName : string
+
+local p = app.params
+local sprite = app.activeSprite
+
+if not sprite then
+  print("ERROR: No active sprite")
+  return
+end
+
+if not p or not p.tagName then
+  print("ERROR: tagName is required")
+  return
+end
+
+for _, tag in ipairs(sprite.tags) do
+  if tag.name == p.tagName then
+    print(true)
+    return
+  end
+end
+
+print(false)

package/build/lua/templates/get_layer_list.lua

@@ -0,0 +1,31 @@
+-- Returns a list of all layers in the active sprite.
+-- Params:
+--   none
+
+local sprite = app.activeSprite
+
+if not sprite then
+  print("ERROR: No active sprite")
+  return
+end
+
+local layers = {}
+
+local function listLayers(layersList)
+  for _, layer in ipairs(layersList) do
+    table.insert(layers, {
+      name = layer.name,
+      index = layer.stackIndex,
+      isGroup = layer.isGroup,
+      visible = layer.isVisible,
+      editable = layer.isEditable
+    })
+
+    if layer.isGroup then
+      listLayers(layer.layers)
+    end
+  end
+end
+
+listLayers(sprite.layers)
+print(json.encode(layers))

package/build/lua/templates/get_palette_info.lua

@@ -0,0 +1,34 @@
+-- Returns information about the palette of the active sprite.
+-- Params:
+--   none
+
+local sprite = app.activeSprite
+
+if not sprite then
+  print("ERROR: No active sprite")
+  return
+end
+
+local palette = sprite.palettes[1]
+
+if not palette then
+  print("ERROR: No palette found")
+  return
+end
+
+local colors = {}
+
+for i = 0, #colors - 1 do
+  local c = palette:getColor(i)
+  table.insert(colors, {
+    r = c.red,
+    g = c.green,
+    b = c.blue,
+    a = c.alpha
+  })
+end
+
+print(json.encode({
+  size = #colors,
+  colors = colors
+}))

package/build/lua/templates/get_selection_bounds.lua

@@ -0,0 +1,24 @@
+-- Returns the bounds of the selection in the active sprite.
+-- Params:
+--   none
+
+local sprite = app.activeSprite
+
+if not sprite then
+  print("ERROR: No active sprite")
+  return
+end
+
+local sel = sprite.selection
+
+if sel.isEmpty then
+  print("ERROR: No selection")
+  return
+end
+
+print(json.encode({
+  x = sel.bounds.x,
+  y = sel.bounds.y,
+  width = sel.bounds.width,
+  height = sel.bounds.height
+}))

package/build/lua/templates/get_tag_list.lua

@@ -0,0 +1,25 @@
+-- Returns a list of all tags in the active sprite.
+-- Params:
+--   none
+
+local sprite = app.activeSprite
+
+if not sprite then
+  print("ERROR: No active sprite")
+  return
+end
+
+local tags = {}
+
+for _, tag in ipairs(sprite.tags) do
+  table.insert(tags, {
+    name = tag.name,
+    from = tag.fromFrame.frameNumber,
+    to = tag.toFrame.frameNumber,
+    direction = tag.aniDir == AniDir.FORWARD and "forward"
+             or tag.aniDir == AniDir.REVERSE and "reverse"
+             or "pingpong"
+  })
+end
+
+print(json.encode(tags))

package/build/lua/templates/merge_visible_layers.lua

@@ -0,0 +1,24 @@
+-- Merges all visible layers into a single layer and saves the result.
+-- Params:
+--   saveOutput  : string
+
+local p = app.params
+
+if not p or not p.saveOutput then
+  print("ERROR: saveOutput is required")
+  return
+end
+
+local sprite = app.activeSprite
+
+if not sprite then
+  print("ERROR: No active sprite")
+  return
+end
+
+app.command.FlattenLayers()
+
+sprite:saveAs(p.saveOutput)
+
+sprite:close()
+print("merge_visible_layers script executed successfully")

package/build/lua/templates/normalize_animation_speed.lua

@@ -0,0 +1,40 @@
+-- Normalize all frame durations to a single targetDuration (seconds).
+-- Params:
+--   inputFile      : string (already opened in Aseprite CLI or app.activeSprite)
+--   saveOutput     : string
+--   targetDuration : string/number (seconds)
+
+local p = app.params
+
+local targetStr = p.targetDuration
+if not targetStr then
+  print("ERROR: targetDuration is required")
+  return
+end
+
+local target = tonumber(targetStr)
+if not target or target <= 0 then
+  print("ERROR: targetDuration must be positive number, got: " .. tostring(targetStr))
+  return
+end
+
+local spr = app.activeSprite
+if not spr then
+  print("ERROR: No active sprite")
+  return
+end
+
+for i, frame in ipairs(spr.frames) do
+  frame.duration = target
+end
+
+local saveOutput = p.saveOutput or p.inputFile
+if saveOutput and saveOutput ~= "" then
+  app.command.SaveFileAs{
+    filename = saveOutput
+  }
+else
+  app.command.SaveFile()
+end
+
+print("normalize_animation_speed script executed successfully")

package/build/lua/templates/recolor_palette.lua

@@ -0,0 +1,131 @@
+-- Recolors the palette based on a mapping of from->to colors.
+-- Params:
+--   saveOutput  : string
+--   mapping     : string ("RRGGBB:RRGGBB;RRGGBB:RRGGBB;...")
+
+local p = app.params
+
+if not p or not p.saveOutput or not p.mapping then
+  print("ERROR: saveOutput and mapping are required")
+  return
+end
+
+local sprite = app.activeSprite
+if not sprite then
+  print("ERROR: No active sprite")
+  return
+end
+
+local function parseColor(hex)
+  hex = hex:lower()
+  if #hex ~= 6 then return nil end
+  local r = tonumber(hex:sub(1, 2), 16)
+  local g = tonumber(hex:sub(3, 4), 16)
+  local b = tonumber(hex:sub(5, 6), 16)
+  return r,g,b
+end
+
+local rules = {}
+for pair in string.gmatch(p.mapping, "([^;]+)") do
+  local fromHex, toHex = pair:match("([^:]+):([^:]+)")
+  if fromHex and toHex then
+    table.insert(rules, {
+      from = fromHex:lower(),
+      to   = toHex:lower()
+    })
+  end
+end
+
+if #rules == 0 then
+  print("ERROR: No valid mapping rules found")
+  return
+end
+
+
+local function recolorIndexed()
+  print("Indexed mode detected: Using palette recolor")
+
+  local basePal = sprite.palettes[1] or sprite.palette
+  if not basePal then
+    print("ERROR: No palette found")
+    return false
+  end
+
+  for i = 0, #basePal - 1 do
+    local c = basePal:getColor(i)
+    local cr = string.format("%02x%02x%02x", c.red, c.green, c.blue)
+
+    for _, rule in ipairs(rules) do
+      if cr == rule.from then
+        local r,g,b = parseColor(rule.to)
+        if r and g and b then
+          basePal:setColor(i,
+            Color{ r=r, g=g, b=b, a=c.alpha }
+          )
+        end
+      end
+    end
+  end
+
+  return true
+end
+
+
+local function recolorRGBA()
+  print("RGBA mode detected: Using pixel replacement")
+
+  app.transaction(function()
+    for _, cel in ipairs(sprite.cels) do
+      local img = cel.image
+      local w = img.width
+      local h = img.height
+
+      for y = 0, h - 1 do
+        for x = 0, w - 1 do
+          local px = img:getPixel(x, y)
+
+          local r = app.pixelColor.rgbaR(px)
+          local g = app.pixelColor.rgbaG(px)
+          local b = app.pixelColor.rgbaB(px)
+          local a = app.pixelColor.rgbaA(px)
+
+          local key = string.format("%02x%02x%02x", r,g,b)
+
+          for _, rule in ipairs(rules) do
+            if key == rule.from then
+              local nr,ng,nb = parseColor(rule.to)
+              if nr and ng and nb then
+                img:putPixel(x, y,
+                  app.pixelColor.rgba(nr,ng,nb,a))
+              end
+            end
+          end
+        end
+      end
+    end
+  end)
+
+  return true
+end
+
+
+local ok = false
+
+if sprite.colorMode == ColorMode.INDEXED then
+  ok = recolorIndexed()
+else
+  print("WARNING: Sprite is NOT Indexed Color.")
+  print("Fallback to RGBA pixel replacement recoloring.")
+  ok = recolorRGBA()
+end
+
+if not ok then
+  print("ERROR: recoloring failed")
+  return
+end
+
+if p.saveOutput and p.saveOutput ~= "" then
+  sprite:saveAs(p.saveOutput)
+end
+
+print("recolor_palette script executed successfully")

package/build/lua/templates/remove_layer_by_name.lua

@@ -0,0 +1,38 @@
+-- Removes a layer by name and saves to a new file (or overwrites).
+-- Params (app.params):
+--   layerName   : string
+--   saveOutput  : string (optional, default = inputFile)
+
+local p = app.params
+
+if not p or not p.layerName or not p.saveOutput then
+  print("ERROR: layerName and saveOutput are required")
+  return
+end
+
+local sprite = app.activeSprite
+if not sprite then
+  print("ERROR: No active sprite")
+  return
+end
+
+local found = false
+
+for i, layer in ipairs(sprite.layers) do
+  if layer.name == p.layerName then
+    app.activeLayer = layer
+    app.command.RemoveLayer()
+    found = true
+    break
+  end
+end
+
+if not found then
+  print("WARN: Layer not found: " .. p.layerName)
+end
+
+if p.saveOutput and p.saveOutput ~= "" then
+  sprite:saveAs(p.saveOutput)
+end
+
+print("remove_layer_by_name script executed successfully")

package/package.json

@@ -1,8 +1,7 @@
 {
   "name": "@iborymagic/aseprite-mcp",
-  "version": "0.4.4",
+  "version": "0.4.6",
   "description": "MCP server for using Aseprite API",
-  "main": "index.js",
   "type": "module",
   "bin": {
     "aseprite-mcp": "./build/index.js"
@@ -10,8 +9,12 @@
   "files": [
     "build"
   ],
+  "publishConfig": {
+    "access": "public"
+  },
   "scripts": {
-    "build": "tsc",
+    "build": "tsc && npm run copy:lua",
+    "copy:lua": "cp -R src/lua/templates build/lua/templates",
     "start": "node build/index.js",
     "dev": "npm run build && npm run start",
     "test": "vitest"