Selector Strings and Named Keywords

This is where people waste time guessing.

Shared keyword value expectations

Verifier enforces:

• :offset -> 3D point
• :rotate -> 3D point
• :origin -> 3D point
• :x -> 3D point on frame ops
• :normal -> 3D point
• clip-box :x/:y/:z -> 2-item numeric list
• :openings -> sketch or sketch-list
• :edges -> edge selector payload
• :faces -> face selector payload

:align

Supported on:

• box
• sphere
• cylinder
• cone

Example:

(box 4 4 4 :align '(min center max))

Rules:

• expects 3-axis tuple
• each axis must be min, center, or max

Edge selectors

Used by ops like fillet and chamfer.

Examples:

• :edges top
• :edges "bottom"
• :edges "left+vertical"
• :edges "target-id:body:edge:0:0-0-0_10-0-0"

Observed canonical meaning:

• top -> boundary z max
• bottom -> boundary z min
• left+vertical -> x-min + axis-z

Face selectors

Used by ops like shell.

Examples:

• :faces "top"
• :faces "planar+normal-z+area-max"
• :faces "target-id:body:face:5:0-0-10:100"

path-frame :at

Accepted anchor values:

• start
• end
• numeric position