AI-native design editor. Open-source Figma alternative.
import { uniq } from 'es-toolkit/array'
import * as v from 'valibot'
import { OpenPencilAPI } from '#core/openpencil-api'
import { defineTool } from '#core/tools/schema'
export const getFontStatus = defineTool({
name: 'get_font_status',
description:
'Report whether fonts used on the current page are faithfully available. Returns requested ' +
'faces, their loaded source, active substitutions, why an installed face could not be ' +
'loaded, and affected nodes.',
execution: { kind: 'sync', mutation: 'none' },
exposure: { webmcp: false },
input: v.strictObject({}),
execute: (figma) => new OpenPencilAPI(figma).getFontStatus()
})
export const listFonts = defineTool({
name: 'list_fonts',
description: 'List fonts used in the current page.',
execution: { kind: 'sync', mutation: 'none' },
exposure: { webmcp: false },
input: v.strictObject({
family: v.optional(v.pipe(v.string(), v.description('Filter by family name (substring)')))
}),
execute: (figma, args) => {
const fonts = new Map<string, Set<number>>()
const page = figma.currentPage
page.findAll((node) => {
if (node.type === 'TEXT') {
const raw = figma.graph.getNode(node.id)
if (raw) {
const key = raw.fontFamily
if (!fonts.has(key)) fonts.set(key, new Set())
fonts.get(key)?.add(raw.fontWeight)
}
}
return false
})
let result = [...fonts.entries()].map(([family, weights]) => ({
family,
weights: [...weights].sort((a, b) => a - b)
}))
if (args.family) {
const q = args.family.toLowerCase()
result = result.filter((font) => font.family.toLowerCase().includes(q))
}
return { count: result.length, fonts: result }
}
})
export const listAvailableFonts = defineTool({
name: 'list_available_fonts',
description:
'List font families the host can render (system fonts on desktop plus any bundled fonts). ' +
'Use this to discover what fonts are available to set on a text node — distinct from list_fonts ' +
'which only reports families currently used in the page.',
execution: { kind: 'async', mutation: 'none' },
exposure: { webmcp: false },
input: v.strictObject({
family: v.optional(
v.pipe(v.string(), v.description('Filter by family name (substring, case-insensitive)'))
)
}),
execute: async (figma, args) => {
const fonts = await figma.listAvailableFontsAsync()
let families = uniq(fonts.map((font) => font.fontName.family))
if (args.family) {
const q = args.family.toLowerCase()
families = families.filter((family) => family.toLowerCase().includes(q))
}
families.sort((a, b) => a.localeCompare(b))
return { count: families.length, fonts: families }
}
})