/**
 * Generic named-socket reader for loaded 3D models. Walks a node tree (any object with `.name`,
 * `.position`, and `.children` — structurally satisfied by `THREE.Object3D`) and collects the local
 * offsets of nodes whose name marks an attachment point. Genre-agnostic: wire anchors on a pylon,
 * muzzle/hand mounts on a character, hardpoints on a ship, seat/decal slots on furniture — anything
 * an artist tags with an empty in the GLB. Pure data (no three.js import), so it lives in core.
 *
 * @capability model-sockets named attachment points read from a model
 */
/** Minimal shape of a model node this reader walks — structurally satisfied by `THREE.Object3D`. */
export interface ModelNode {
    name: string;
    position: {
        x: number;
        y: number;
        z: number;
    };
    children?: readonly ModelNode[];
}
/** One resolved socket: its node name and local-space offset from the model origin. */
export interface ModelSocket {
    name: string;
    offset: readonly [number, number, number];
}
/** Default socket-name matcher: "socket", "wire", "attach", "anchor", "mount", "hardpoint" (any case). */
export declare const SOCKET_PATTERN: RegExp;
/**
 * Depth-first collect every socket-named node's local offset, sorted by descending Y then ascending X
 * so socket indices are stable across loads (top first, left-to-right). Empty when the model tags
 * none — callers then fall back to computed offsets. Pass a custom `pattern` for a bespoke naming
 * convention.
 */
export declare function readNamedSockets(root: ModelNode, pattern?: RegExp): ModelSocket[];