FacetDocs

Result codes

Every reply lists what did not happen as asked. Each warning names the layer and the fix; the app shows the same warnings as badges on the canvas.

CodeMeaning
INPUT_ALIASEDnote: a key or value was read in its canonical form
INPUT_IGNOREDa key was not understood and did nothing; fix the spelling it names
NOT_APPLIEDasked for X, got Y; change the request or the parent
NOT_SUPPORTEDthe engine cannot do this yet; the rest of the call was applied
SVG_TEXT_DROPPEDpart of an $svg's text (a <textPath>, a turned group, per-letter positions) is not mapped to its text layers
SVG_FEATURE_IGNOREDan $svg's filter, image, or a mask or clip path inside a masked element is not applied; its shapes draw without it
LAYOUT_TIGHTa note: content overflows by 2 px or less (scaled type, a turned corner); reported apart so real overflow stands out
PREVIEW_WIDERa note: layers reach past the frame a build made (a connector looping outside it), so its preview shows more than the frame
PART_CLIPPEDa note: a kit part clips by its own definition (a phone's screen) and the content given to it is larger, so part of it does not show
FONT_FEATURE_MISSINGa fontFeatures tag the text's font does not have (small capitals in Inter): the text draws without it
ROW_UNEVENa note: boxes in a row hug their content and come out different heights; "align": "stretch" on the row makes them one height (center or end silences it)
OUT_OF_GAMUTa note: a CSS Color 4 color (oklch, lab, display-p3…) lies outside sRGB; it is drawn as the hex the note names, by CSS gamut mapping
LAYOUT_OVERFLOWcontent is clipped by a fixed-size frame (also content spilling out of a filled child), shows past the edge of a frame that neither hugs nor clips it, or is pushed into a fixed frame's end padding along its flow
EXPECT_FAILEDa layer's expect (lines, fits, size, noOverlap) did not hold
LAYOUT_OCCLUDEDan edge-pinned bar or overlay covers content
FRAMES_OVERLAPtwo top-level frames on the page overlap; move one below or right of the other
VECTOR_HEAVYone call drew 200,000 path points or more: a repeating texture is a pattern fill ({"fill": {"pattern": "halftone"}}), one small tiled picture
TEXT_UNREADABLEa text is the colour of the fill behind it, so its words cannot be seen
NO_ROOMa note: justify or a filling child has no room to work with, because the container hugs its content on that axis
TEXT_TRUNCATEDtext does not fit its fixed box
TEXT_OVERFLOWa one-line text runs past the width its frame gives it; give it "width": "fill" or a fixed width
FONT_ALIASEDa note: a CSS font list, a system keyword or a vendor's renamed family read as the family it stands for (Slack-Lato as Lato)
FONT_SUBSTITUTEDa requested font family is not installed; another one draws the text
IMAGE_UNREADABLEan image file's data past its header is damaged or cut short; the layer draws what of it decodes, or nothing
TOKEN_FALLBACKa variable was not found; its fallback value was used
OVERRIDE_UNMATCHEDan instance override names no property or layer
FONT_INSTALLEDnote: a font family missing on this machine was installed from Google Fonts for this host
IMAGE_SOURCEnote: where a fetched photo came from: title, author, license and page
HISTORY_EMPTYnote: undo or redo found nothing to step
GLYPH_FALLBACKnote: a font has no glyph for a character, so another font draws it
FONT_STYLE_MISSINGnote: a family has no italic, so italic text in it shows upright
NAME_TAKENa build with again added a top-level layer under a name another one already has; later calls naming it match both
GLYPH_MISSINGno font here has a character, so it shows as a missing-glyph box
TEXT_FLOWnote: the frames a story flows through, and how much of it the last does not hold
RUNT_FRAMEa story's last frame holds only a line or two of it
HEAD_AT_FOOTa heading is the last line of a frame, its text in the next
GRID_DRIFTa story's lines leave its baseline grid, so facing frames' baselines stop lining up
STRAIGHT_QUOTESrunning text uses straight quotes or apostrophes where typographic ones belong
SPLIT_UNITa line breaks between a number and its unit
HYPHEN_LADDERmore than two lines in a row end in a hyphen
LOOSE_LINEnote: justified lines stretch their word spaces past twice a normal space
CLIPPED_BY_PARENTcontent the layout pushed out of a frame is hidden by an ancestor that clips on purpose
TEXT_CELL_WRAPnote: a text given no width would run past its grid cell, so it wraps at the cell's width; give it a width to choose another
KIT_LIBRARYa kit's library (kit.use): a note of what the file took from it when it changed, or a warning that it could not be read and what it gave before is kept
ICON_COMPONENTa note: an icon became a component in the Icons frame, and every use of it is an instance; one line for all the icons of a call
REPLACEDa note: what build --replace swapped, and where instances went
BEHAVIOR_STOREDa note: a set's behavior was stored as a feature; facet chart NAME checks it
INSTANCE_PROPSa note: keys of a modify were set as an instance's properties
NO_MATCHa note: a selector matched nothing, with the nearest layer name or the form to write
LAYOUT_ADJUSTEDa note: the build changed a layout value so the result shows (a hugging row with a filling child fills; a shape with no paint gets a stroke)
INFOa note for the reader, nothing to fix: where a file was written, which document was used
VARIANTS_ALIKEa note: every variant of a component set looks the same, so its variant property changes nothing
MANY_MATCHEDa note: a name in $nodes matched several layers and all were changed
NO_RULESa note: lint checked nothing, because the file has no DESIGN.md rules and no design system
ICON_SETa note: the design has an Icons frame; assets export --set Icons writes one named file per icon
FONT_FITnote: the size a text with fontSize "fit" took: the largest at which it fits its box, its maxLines or one line
TEXT_ELLIPSISnote: a maxLines text ends in an ellipsis, so part of it is not shown
SYNC_SWAPPEDnote: a sync removed a layer and added another under one parent, which is what a rename looks like; a key on the layer keeps it
SYNC_RESETnote: a sync set a key back to its default because the source no longer writes it
CONNECTOR_CROSSESwarning: a connector's line passes through a layer it does not join; route it with sides or an elbow, or move the layers
SYNC_PRUNEDnote: a sync with prune removed the page's top-level layers the call no longer writes
SYNC_REBUILTnote: a sync built a layer again because the source writes it as another kind (a row as a column): it and its children have new ids
SCRIPT_LOGnote: a line a script wrote with console.log
SCRIPT_ERRORerror: a script threw or ran out of time; everything it did was rolled back
INVALID_INPUTerror: nothing changed; the message says what to fix
NOT_FOUNDerror: a node, component or variable does not exist
FILE_NOT_FOUNDerror: a "file" argument names a file other than the one this host serves
UNKNOWN_TOOLerror: no tool has that name; the message suggests one
ENGINE_ERRORerror: the engine refused a step; nothing changed
READ_ONLYerror: the file was made by a newer Facet and opened read-only; nothing changed (save --to COPY.facet writes a copy you can edit)

Documentation for Facet 0.3.228-g032727de