Skip to content

v75-upgrade-notes.md

Latest commit

 

History

History
102 lines (71 loc) · 3.81 KB

v75-upgrade-notes.md

File metadata and controls

102 lines (71 loc) · 3.81 KB
Raw

Hoist React v75 Upgrade Notes

From: v74.x → v75.0.1 | Released: 2025-08-11 | Difficulty: 🟢 LOW

Overview

Hoist React v75 is a straightforward release that removes several previously deprecated APIs and introduces a minor change to Cube View row data objects. Most apps will only need to search for and remove references to the deprecated APIs listed below.

The most significant app-level impacts are:

  • Removed deprecated APIs — LoadSupport.isLoadSupport, FileChooserModel.removeAllFiles, FetchService.setDefaultHeaders, FetchService.setDefaultTimeout, and IdentityService.logoutAsync have all been removed.
  • Cube View row data change — the undocumented _meta and buckets properties on View row objects have been removed. Apps using the Cube/View system should verify they are not referencing these internal properties.

Prerequisites

Before starting, ensure:

  • Running hoist-react v74.x

Upgrade Steps

1. Update package.json

Bump hoist-react to v75.

File: package.json

Before:

"@xh/hoist": "~74.1.0"

After:

"@xh/hoist": "~75.0.0"

2. Remove Deprecated API Usage

The following APIs were deprecated in earlier releases and have now been removed. Search for any remaining references and replace them.

Find affected files:

grep -rE "isLoadSupport|removeAllFiles|setDefaultHeaders|setDefaultTimeout|logoutAsync" client-app/src/
Removed API Replacement
LoadSupport.isLoadSupport No direct replacement needed — this was a type-check utility rarely used by apps
FileChooserModel.removeAllFiles Use FileChooserModel.clear()
FetchService.setDefaultHeaders Set FetchService.defaults.headers directly
FetchService.setDefaultTimeout Set FetchService.defaults.timeout directly
IdentityService.logoutAsync Use XH.logoutAsync()

3. Check for Cube View Row Data Changes

The undocumented _meta and buckets properties on row objects returned by Cube View have been removed. Row data is now emitted as typed ViewRowData objects with documented properties.

Find potentially affected files:

grep -rE "_meta|\.buckets" client-app/src/ | grep -iE "cube|view|query|dimension"

If matches are found, review each usage. These were internal/undocumented properties, and there is no one-for-one replacement — consult the ViewRowData class for the supported public API, or contact XH for guidance on migrating specific patterns.

Ensure you call the developer's attention to any such usages, as these are advanced cases and will require direct developer review. Do not attempt to auto-update such usages yourself.

4. Review Precisely Sized Form Inputs (Visual Check)

Hoist v75 upgrades the default Inter UI font from v3 to v4.1 (Inter Var → InterVariable). The --xh-font-family CSS variable is updated automatically, so most apps will see no impact. However, the new font version includes subtle changes to letter spacing and tabular number widths.

If your app has form inputs — especially date inputs — that are precisely sized to just fit their contents (e.g. via explicit width values in CSS or inline styles), review them visually after upgrading. Values that fit perfectly before may now be slightly clipped or overflow. Widen any affected inputs as needed.

Verification Checklist

After completing all steps:

  • yarn install / npm install completes without errors
  • npx tsc --noEmit passes
  • Application loads without console errors
  • No removed APIs remain: grep -rE "isLoadSupport|removeAllFiles|setDefaultHeaders|setDefaultTimeout|logoutAsync" client-app/src/
  • Cube/View-based visualizations render correctly (if applicable)

Reference