features: { assistance: false } to disable the
action; read-only, disabled and field permissions also apply.
Pure core API
ImportAssistanceProposal includes kind (gradient or alignment),
field (motd, version, hover), detached full original and candidate
documents, maximumColorError, maximumPositionError and removedPadding
(the count of leading ASCII spaces replaced by alignment). The caller’s input
is never mutated. Other document fields/extensions remain unchanged.
ImportAssistanceOptions requires profile and a positive finite width.
Tolerance values must be finite and within their documented bounds; invalid
options return no proposals. The DOM tool supplies its actual entry text width
and filters candidates by editable fields. Standalone core consumers must apply
their own permission and stale-result checks.
Analysis is conservative and bounded to 2,048 graphemes, 4,096 nodes and 32
group levels per field. These limits are checked before allocating flattened
glyphs. Fields with
placeholders, protected components, existing gradients/rainbows or obfuscated
text are skipped. Gradient compaction requires a single line, uniform non-color
style and fewer stops than characters. Alignment requires at most two explicit
MOTD lines, leading ASCII spaces and no wrapping, unsupported glyph/layout
diagnostics or nonfinite advances. It leaves existing alignment and trailing
whitespace intact. These omissions produce no proposal, not lossy fallback.
Font precision depends on the supplied profile’s metrics; this API does not
inspect an arbitrary host font’s rasterization.
suggestSimplification(text, { tolerance }) remains available as the lower-level
color proposal API. It now also skips placeholders, preserving their semantic
identity rather than flattening their source spelling into text.