batchutil

Documentation

Index

• Variables
• func BuildContext(steps []StepState) map[string]interface{}
• func ExpandAllComposites(ops []map[string]interface{}) ([]map[string]interface{}, error)
• func ExpandComposite(op map[string]interface{}) ([]map[string]interface{}, error)
• func FixBatchOps(data []byte) ([]byte, []string, error)
• func InterpolateParams(params map[string]interface{}, steps []StepState) (map[string]interface{}, error)
• func InterpolateValue(value interface{}, ctx map[string]interface{}) (interface{}, error)
• func IsComposite(command string) bool
• func NormalizeBatchParams(command string, params map[string]interface{}) map[string]interface{}
• func NormalizeCSSProps(params map[string]interface{}) map[string]interface{}
• func ResolveTokenAliases(ops []map[string]interface{}) (applied int, rootWidth int)
• func SanitizeStepName(name string) string
• func StripJSONComments(data []byte) []byte
• func StripMarkdownFences(data []byte) []byte
• type StepState

Variables

var KnownTopLevelProps = []string{
	"x", "y", "width", "height", "w", "h",
	"color", "fillColor", "bg",
	"fontSize", "fontFamily", "fontStyle", "sz", "ff", "fs",
	"parentId", "pid",
	"cornerRadius", "r",
	"layoutMode", "itemSpacing", "padding", "opacity",
	"text", "imageData", "stroke", "strokeWidth",
}

KnownTopLevelProps are design properties that belong inside "params", not at op root. Exported so validate.go can reference the same list.

Functions

func BuildContext

func BuildContext(steps []StepState) map[string]interface{}

BuildContext creates an interpolation context from completed steps.

func ExpandAllComposites

func ExpandAllComposites(ops []map[string]interface{}) ([]map[string]interface{}, error)

ExpandAllComposites processes a batch array, expanding any composite ops.

func ExpandComposite

func ExpandComposite(op map[string]interface{}) ([]map[string]interface{}, error)

ExpandComposite expands a single composite op into primitive batch ops. Non-composite commands pass through as single-element slices.

func FixBatchOps

func FixBatchOps(data []byte) ([]byte, []string, error)

FixBatchOps applies auto-corrections to common LLM output drift. Returns: fixed JSON bytes, list of human-readable fix descriptions, error. Error is non-nil only if the input cannot be parsed at all.

func InterpolateParams

func InterpolateParams(params map[string]interface{}, steps []StepState) (map[string]interface{}, error)

InterpolateParams resolves placeholders in params using prior step results.

func InterpolateValue

func InterpolateValue(value interface{}, ctx map[string]interface{}) (interface{}, error)

InterpolateValue recursively resolves placeholders in arbitrary JSON-like data.

func IsComposite

func IsComposite(command string) bool

IsComposite returns true if command is a composite that needs expansion.

func NormalizeBatchParams

func NormalizeBatchParams(command string, params map[string]interface{}) map[string]interface{}

NormalizeBatchParams expands shorthand keys for batch operations. It is intentionally command-aware to avoid key collisions.

func NormalizeCSSProps

func NormalizeCSSProps(params map[string]interface{}) map[string]interface{}

NormalizeCSSProps maps CSS-like properties to Figma-native properties. It is called during batch parameter normalization so LLMs can write familiar CSS properties. CSS props are lower priority — they never overwrite Figma-native properties that are already set. The function modifies params in-place AND returns it.

func ResolveTokenAliases

func ResolveTokenAliases(ops []map[string]interface{}) (applied int, rootWidth int)

ResolveTokenAliases resolves semantic token aliases (e.g. sz:"hero", padding:"side", w:"content") to numeric values based on the first root frame's canvas size. It mutates ops in place and returns:

• applied: number of alias replacements made
• rootWidth: detected root frame width (0 if none found)

func SanitizeStepName

func SanitizeStepName(name string) string

SanitizeStepName normalizes a batch step name: lowercase, spaces→underscores, strip non-alphanumeric characters (except _).

func StripJSONComments

func StripJSONComments(data []byte) []byte

StripJSONComments removes // line comments and /* block comments */ from JSON-like input. Models occasionally emit JSONC-style comments which are not valid JSON.

func StripMarkdownFences

func StripMarkdownFences(data []byte) []byte

StripMarkdownFences removes ```json ... ``` or ``` ... ``` wrappers that models add even when explicitly told not to.

Types

type StepState

type StepState struct {
	Index   int
	Name    string
	Command string
	OK      bool
	Result  interface{}
	Error   string
}

StepState captures the execution state of a prior batch step.