Yarn

Added

• Bare links in Table cells and text fields (#2). With Hard-coded links in content on, a value that is nothing but a URL on this site — /media/downloads/policy.pdf typed into a Table field's Link column, a Plain Text “button URL” field, the URL in a Link field — now counts as a link to the page or asset it points at, so that asset no longer reads as unused, and deleting it shows up as a broken link. Only whole values are read: a path mentioned in a sentence isn't a link.
• Fields holding links setting (linkFields). Leave it empty to read bare URLs in every field, or pick the fields that hold links to read only those — useful when a Plain Text field elsewhere holds paths that aren't links. href and src in markup are read everywhere either way.

Fixed

• The map no longer piles every element into its top-left corner on a busy site (#1). On a graph where a few elements hold hundreds of relations between them, the layout pulled each of those hubs by every one of its threads at once, overshot further on every step, and within a second or two had flung them past what the browser can draw — at which point every element was drawn on top of the next in the corner, labels cut off by the edge of the canvas. Each thread now pulls its two ends in proportion to how busy they are, and no element can jump more than a short distance in one step.

Added

• Findings digest. Yarn can email what it has found since the last digest — daily or weekly, at an hour you choose, to a list of recipients (or an environment variable) — so a broken reference tag or a live page pointing at a disabled entry is noticed without anybody opening Yarn. It sends once per period, and only when there is something new unless you ask for an “all clear”. Set it up under Yarn → Settings → Findings digest.
• php craft yarn/digest/send for cron (safe to run every few minutes; it sends once per period) and yarn/digest/status. Sites without cron can leave “Check from web requests too” on, and the digest is queued from ordinary traffic instead.
• Send a test digest now, on the Findings and Settings screens, behind a new Send a test findings digest permission.
• A Used by column for the Assets and Entries indexes, counted for the whole page in one query.
• An Is used condition rule for assets and entries — filter an index to the unused images in a volume and combine it with Craft’s own filters and bulk actions. It counts relation fields, as the Relations panel does, and runs as a single database subquery.
• Digest::EVENT_BEFORE_SEND, to change a digest’s recipients or content, or cancel it.

Changed

• Yarn now has one database table, yarn_digests, holding the digest’s “last sent” marker. Run php craft up after updating.

Fixed

• The map no longer leaves elements and their names off the edge of the canvas (#1). It was framed once, a second after loading, while the layout was still spreading out, and the framing measured the dots but not their labels — so the outer elements drifted off the canvas and their names ran off it, some of them under the legend. The map now frames itself again when the layout settles (unless you've panned or zoomed since), takes the labels into account, keeps clear of the Fit / Re-settle buttons, and zooms out as far as a large graph needs.
• “Show only” is a proper multi-select (#1). It was a bare browser list — “0 selected” in Chrome, a two-row scrolling box in Firefox. It's now Craft's own multi-select: type to find a source, remove one with its ×. So are the Ignored fields and Excluded sources settings.
• The legend and status line sit in a bar above the map instead of floating over it, where they hid whatever the layout put underneath.
• The Volume, Source and Check filters on Asset usage, Browse and Findings are Craft's styled selects rather than bare browser controls.
• “Hide unconnected” and “Only the unused ones” read as checkboxes, not as uppercase field headings.
• On a computer set to dark mode, the map's legend, detail panel and labels turned dark on the light control panel. The control panel has no dark mode, so that styling has gone.

Changed

• The control panel styles use Craft's own colour variables throughout, and the templates no longer carry inline styles.
• The map zooms in at most 1.5× when it frames itself, so a graph of two or three elements isn't blown up to headline size. Scrolling still zooms further.

Initial release.

• Relation graph assembled from Craft’s relations table, reference tags in content, structure hierarchy and hard-coded links, with relations inside nested elements rolled up onto their owners.
• Map: force-directed, colour-coded by element kind, with filters, search, selection and a focus mode for one element’s neighbourhood.
• Browse, Asset usage and Globals screens.
• Per-element view: both directions grouped by field, plus knock-on impact at up to three removes.
• Eight findings checks: relations into the trash, relations to elements missing from the site, live elements pointing at things that are not live, references that resolve to nothing, orphans, unused assets, circular relations and self-references.
• A Relations panel in the sidebar of every element edit screen.
• craft.yarn Twig variable.
• Console commands for the map, an element, findings, paths and export.
• Export to JSON, CSV, Graphviz DOT and Mermaid.
• RegisterEdgeSourcesEvent, BuildGraphEvent and DefineFindingsEvent for plugins that store their own references.