KiCad - the KiCad Bridge

@@ -2807,6 +2807,80 @@ def _ui_wm_command(frame_index: int, menu_id: int) -> dict:  # --- request dispatcher ---------------------------------------------------- ++def _ui_probe_footprint(library: str, footprint: str) -> dict:+    """Ask KICAD ITSELF whether it can see and load this footprint.++    Wiki issue #44 (John): "existsInLibrary is a filename check, so it answers+    'is there a file called this' rather than 'can KiCad load this'. Those+    diverge in exactly this failure." He is right, and only code running INSIDE+    pcbnew can answer the second question - which this is.++    Three distinct answers, where the directory listing could only give one:+      * the library is not registered with KiCad at all (fp-lib-table)+      * KiCad enumerates the library but the name is not in ITS list+      * the name is listed but LOADING it raises - and then we return KiCad's+        own parse error, which is the thing nobody outside the process can see.+    """+    import pcbnew  # available only inside a KiCad process++    out = {"library": library, "footprint": footprint}+    try:+        tbl = pcbnew.GetGlobalFootprintTable()+    except Exception as e:+        out["error"] = f"no footprint table: {type(e).__name__}: {e}"+        return out++    try:+        nicks = [str(n) for n in tbl.GetLogicalLibs()]+    except Exception as e:+        nicks = []+        out["libListError"] = f"{type(e).__name__}: {e}"+    out["registeredLibraries"] = nicks+    out["libraryRegistered"] = library in nicks+    if not out["libraryRegistered"]:+        out["verdict"] = ("LIBRARY NOT REGISTERED: KiCad has no fp-lib-table row for "+                          f"'{library}', so nothing in it can load regardless of the files.")+        return out++    try:+        listed = [str(n) for n in tbl.FootprintEnumerate(library, False)]+    except Exception as e:+        out["enumerateError"] = f"{type(e).__name__}: {e}"+        listed = []+    out["kicadListCount"] = len(listed)+    out["inKicadList"] = footprint in listed+    if listed and not out["inKicadList"]:+        near = [n for n in listed if footprint.lower() in n.lower()+                or n.lower() in footprint.lower()][:5]+        out["kicadNearby"] = near+        out["verdict"] = ("ON DISK BUT NOT IN KICAD'S LIST: the file exists, and KiCad's own "+                          "enumeration of this library does not contain that name. KiCad is "+                          "reading a different set of files than the directory listing shows.")+        return out++    # The decisive step: make KiCad actually parse it.+    try:+        mod = tbl.FootprintLoad(library, footprint)+        if mod is None:+            out["loads"] = False+            out["verdict"] = ("LISTED BUT LOADS AS NULL: KiCad enumerates the name but returns "+                              "no footprint for it.")+        else:+            out["loads"] = True+            try:+                out["padCount"] = int(mod.GetPadCount())+            except Exception:+                pass+            out["verdict"] = ("LOADS FINE: KiCad can enumerate AND parse this footprint, so any "+                              "failure to show it is in the editor navigation, not the library.")+    except Exception as e:+        out["loads"] = False+        out["loadError"] = f"{type(e).__name__}: {e}"+        out["verdict"] = (f"KICAD REFUSES TO LOAD IT: {type(e).__name__}: {e}. This is KiCad's "+                          "own parser talking - the file is present but it will not open.")+    return out+ def _dispatch(method: str, params: dict) -> Any:     if method == "ping":         return {@@ -2830,6 +2904,9 @@ def _dispatch(method: str, params: dict) -> Any:         return _call_on_ui_thread(_ui_get_schematic_info)     if method == "get_open_editors":         return _call_on_ui_thread(_ui_get_open_editors)+    if method == "probe_footprint":+        return _call_on_ui_thread(lambda: _ui_probe_footprint(+            str(params.get("library") or ""), str(params.get("footprint") or "")))     if method == "get_pcb_footprints":         return _call_on_ui_thread(_ui_get_pcb_footprints)     if method == "get_pcb_layers":