Skip to content

AI-native design editor. Open-source Figma alternative.

2.6 KB
Raw Blame
import * as v from 'valibot'

import { prepareSlotInsertion } from '#core/figma-api/slots'
import { getComponentCatalog } from '#core/tools/component-catalog'
import { toolNumber, defineTool } from '#core/tools/schema'

export const listLibraries = defineTool({
  name: 'list_libraries',
  description: 'List available published component libraries.',
  execution: { kind: 'async', mutation: 'none' },
  exposure: { webmcp: false },
  input: v.strictObject({}),
  execute: async (figma) => {
    const catalog = getComponentCatalog(figma.graph)
    const libraries = catalog ? await catalog.listLibraries() : []
    return { count: libraries.length, libraries }
  }
})

export const insertLibraryComponent = defineTool({
  name: 'insert_library_component',
  description:
    'Insert a reusable component from an enabled library by stable library and asset identity.',

  execution: { kind: 'async', mutation: 'document' },
  input: v.strictObject({
    library_id: v.pipe(v.string(), v.description('Library ID')),
    revision_id: v.optional(v.pipe(v.string(), v.description('Pinned revision ID'))),
    asset_key: v.pipe(v.string(), v.description('Stable asset key')),
    parent_id: v.optional(v.pipe(v.string(), v.description('Optional parent node ID'))),
    x: v.optional(toolNumber(v.pipe(v.number(), v.description('X position')))),
    y: v.optional(toolNumber(v.pipe(v.number(), v.description('Y position')))),
    variant_values: v.optional(
      v.pipe(v.string(), v.description('Optional JSON object of variant property values'))
    )
  }),
  execute: async (figma, args) => {
    if (args.parent_id)
      prepareSlotInsertion(figma.graph, args.parent_id, 'insert_library_component')
    const catalog = getComponentCatalog(figma.graph)
    if (!catalog) throw new Error('No component library catalog is configured')
    let variantValues: Record<string, string> | undefined
    if (args.variant_values) {
      const parsed: unknown = JSON.parse(args.variant_values)
      if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
        throw new TypeError('variant_values must be a JSON object')
      }
      const entries = Object.entries(parsed)
      if (entries.some(([, value]) => typeof value !== 'string')) {
        throw new TypeError('variant_values values must be strings')
      }
      variantValues = Object.fromEntries(entries)
    }
    return catalog.insertComponent({
      libraryId: args.library_id,
      revisionId: args.revision_id,
      assetKey: args.asset_key,
      parentId: args.parent_id,
      x: args.x,
      y: args.y,
      variantValues
    })
  }
})