Function postProcessStructure

src/nodes/process/structure/utils.ts:236–321

(structure?: Protocol | Protocol[] | null, frames?: FigmaFrameInfo[])

 * @param frames - The Figma frames tree for element extraction
 */
export function postProcessStructure(structure?: Protocol | Protocol[] | null, frames?: FigmaFrameInfo[]): void {
    if (!structure) {
        return;
    }

    // Utility to join alias path segments (always POSIX '/')
    const joinSegments = (...segments: (string | undefined)[]): string =>
        path.posix.join(...segments.filter((segment): segment is string => Boolean(segment && segment.length)));

    const nodes = Array.isArray(structure) ? structure : [structure];
    let rootPath = '@/components';

    // Convert component name to kebab-case for file naming
    const toKebabName = (node: Protocol): string => {
        const source = node.data.kebabName || node.data.name || node.id || 'component';
        const kebabName = toKebabCase(source);
        if (!node.data.kebabName) {
            node.data.kebabName = kebabName;
        }
        return kebabName;
    };

    const traverse = (node?: Protocol | null, parentPath?: string, level = 0): void => {
        if (!node || !node.data) {
            return;
        }

        // 1. Normalize componentName (from top-level to data field)
        const extendedNode = node as ExtendedFrameStructNode;
        const topLevelComponentName = extendedNode.componentName;
        if (topLevelComponentName && !node.data.componentName) {
            node.data.componentName = topLevelComponentName;
            delete extendedNode.componentName;
        }

        // 2. Populate elements data from elementIds
        if (frames) {
            const nodeData = node.data as FrameData & { elementIds?: string[] };
            const elementIds = nodeData.elementIds;
            if (elementIds && Array.isArray(elementIds)) {
                if (elementIds.length > 0) {
                    node.data.elements = extractHierarchicalNodesByIds(frames, elementIds, { includeSubtree: true });
                } else {
                    node.data.elements = [];
                }
                delete nodeData.elementIds;
            } else {
                node.data.elements = node.data.elements || [];
            }
        }

        // 3. Annotate with file system paths
        const segment = toKebabName(node);
        let currentPath: string;

        if (level === 0) {
            // Root node always uses base path
            currentPath = rootPath;