Update numpy-documentation-search extension

extensions/numpy-documentation-search/CHANGELOG.md

@@ -1,13 +1,27 @@
 # NumPy Documentation Search Changelog
 
+## [1.3.0] - {PR_MERGE_DATE}
+
+### Added
+
+- Add guided recovery when live access to `numpy.org` fails, including in-app setup steps for downloaded local docs
+- Add configurable documentation source preferences for auto and local directory modes
+
+### Changed
+
+- Fall back to local documentation when remote inventory loading fails
+- Load inline documentation previews from a configured local docs directory when network access is unavailable
+
 ## [1.2.3] - 2025-10-09
 
 ### Changed
+
 - Refresh README to focus on a concise Raycast user overview with key in-app features
 
 ## [1.2.2] - 2025-10-07
 
 ### Fixed
+
 - Fix TypeScript compilation errors in strict mode
   - Updated Cheerio type annotations to use `Cheerio<AnyNode>` with proper imports from domhandler
   - Added explicit type annotations for `.each()` callback parameters to resolve implicit any errors
@@ -16,11 +30,13 @@
 ## [1.2.1] - 2025-10-07
 
 ### Fixed
+
 - Remove ufunc assignment notation from function signatures - Universal function signatures no longer show `= <ufunc 'name'>` suffix
 
 ## [1.2.0] - 2025-10-07
 
 ### Added
+
 - **Prefix Toggle Preference**: New user preference to display 'np.' instead of 'numpy.' prefix throughout the extension
   - Default setting uses 'np.' prefix (e.g., 'np.array' instead of 'numpy.array')
   - Applies to search results (title and subtitle), function signatures, and all action menus
@@ -30,11 +46,13 @@
 ## [1.1.1] - 2025-10-07
 
 ### Fixed
+
 - Remove hash fragments from documentation URLs - URLs now open to the clean page URL (e.g., `https://numpy.org/doc/stable/reference/generated/numpy.absolute.html`) instead of including the anchor fragment (e.g., `https://numpy.org/doc/stable/reference/generated/numpy.absolute.html#numpy.absolute`)
 
 ## [1.1.0] - 2025-10-07
 
 ### Fixed
+
 - Preserve inline code blocks in parameter descriptions - code references like `endpoint`, `False`, and `num + 1` now appear with proper backtick formatting instead of plain text
 
 ## [1.0.0] - 2025-10-07

extensions/numpy-documentation-search/README.md

@@ -8,3 +8,17 @@ A Raycast extension that lets you search the NumPy API reference and preview det
 - **Rich previews**: See inline call signatures, parameter tables, return values, and version notes without leaving Raycast.
 - **Doc deep links**: Open the exact section on numpy.org in your browser when you need the full documentation context.
 - **Copy-ready snippets**: Copy function signatures or doc URLs directly from the command for fast handoff into notebooks, scripts, or PRs.
+
+## Certificate-Restricted Networks
+
+If your work network blocks access to `https://numpy.org/doc/stable/`, the extension now shows a guided recovery state instead of only surfacing the fetch error.
+
+You can point the command at downloaded local documentation:
+
+1. Obtain a generated NumPy docs copy from [numpy/doc](https://github.com/numpy/doc) or from another machine that can reach `numpy.org`.
+2. Extract the download locally and select the downloaded docs folder in Raycast. The extension will load the documentation from its `stable` subfolder.
+3. Open the command preferences and set:
+   - `Documentation Source` to `Local Docs Directory`, or leave it on `Online`
+   - `Local Docs Directory` to the downloaded docs folder
+
+If no local docs are configured, the extension requires live access to `numpy.org`. Local HTML docs provide full inline previews without network access.