Yfiles nodestyle interaction

Skill yWorks/yfiles-for-html-skills/skills/yfiles-nodestyle-interaction

Comprehensive Claude Code plugin for yFiles for HTML development - includes skills for initialization, graph building, layouts, custom styling, and interactive features

Install

npx -y skills add yWorks/yfiles-for-html-skills --skill yfiles-nodestyle-interaction

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

This skill should be used when the user asks to "implement hit testing", "add custom click area", "implement isHit", "implement getOutline", "fix edge cropping", or mentions "hit testing", "isHit", "getOutline", "edge cropping", or "edge connection points" in a node style context.

SKILL.md

2.5 KB, as published. Nobody here has run it

Node Style Interaction

Implement custom hit testing and edge cropping for accurate user interaction with non-rectangular node shapes.

Before Implementing

Always query the yFiles MCP for current API:

yfiles:yfiles_get_symbol_details(name="NodeStyleBase")
yfiles:yfiles_list_members(name="NodeStyleBase")
yfiles:yfiles_search_by_description(query="hit testing")
yfiles:yfiles_get_symbol_details(name="GeneralPath")

Quick Start

export class InteractiveNodeStyle extends NodeStyleBase {
  protected isHit(
    context: IInputModeContext,
    location: Point,
    node: INode
  ): boolean {
    return node.layout.toRect().contains(location, context.hitTestRadius)
  }

  protected getOutline(node: INode): GeneralPath | null {
    const { x, y, width, height } = node.layout
    const path = new GeneralPath()
    path.appendRectangle(new Rect(x, y, width, height), false)
    return path
  }
}

Core Concepts

isHit(): Determines whether a point hits the node — implement for non-rectangular shapes
getOutline(): Defines the node boundary for edge cropping — implement when edges should terminate at the custom shape edge
hitTestRadius: Tolerance area around shape edges, provided by context.hitTestRadius
GeneralPath: Arbitrary shape definition for outlines and hit regions

When to Implement Each Method

isHit(): Node shape is not rectangular (ellipses, polygons, custom paths)
getOutline(): Edges should crop cleanly at the visible shape boundary

Note: When implementing yFiles interfaces, always use BaseClass() wrapper instead of TypeScript implements. The @yfiles/eslint-plugin rule @yfiles/fix-implements-using-baseclass enforces this pattern.

Additional Resources

references/examples.md — Hit testing for custom shapes, exclusion areas, circular/elliptical hit testing, complex outlines
references/reference.md — Method signatures, GeneralPath API, geometric utilities

Related Skills

/yfiles-nodestyle-basic — Basic rendering
/yfiles-nodestyle-configure — Configuration
/yfiles-nodestyle-advanced — Performance and group nodes