grist-widget-sdk 0.3.17 → 0.3.25

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # grist-widget-sdk
 
+## 0.3.25
+
+### Patch Changes
+
+- bbcca4d: New: shared TypeScript settings for widgets, to `extends` from a widget's own tsconfig files. `grist-widget-sdk/tsconfig/app.json` covers the browser code in `src/` (bundler resolution, `react-jsx`, `strict` and the unused-code checks); `grist-widget-sdk/tsconfig/node.json` covers `vite.config.ts`. Both are the settings scaffolded widgets have used so far, so a compiler-setting change can now reach widgets with an SDK update instead of a hand edit in each one. They need TypeScript 5.8 or later. A change that makes a check stricter can fail a widget's typecheck, so it only ships in a minor release.
+
+## 0.3.20
+
+### Patch Changes
+
+- 87d98f0: Fix declaration emit for code that wraps SDK hooks. A library compiled with `declaration: true` that re-exported `useGristStatus()` or `useGristHandshake().status` with an inferred type failed with TS2883 (TS2742 before TypeScript 6), "cannot be named without a reference to '…/dist/use-grist-widget-options-from-context-…'", because those signatures reached types that only a private build chunk exported.
+  
+  The types involved are now public: `UseGristStatusResult`, `UseGristSelectionResult`, `UseGristWritesResult` and `UseGristThemeResult` (the slice-hook return types the docs already named, now exported and used as the hooks' declared return types), plus `UseGristCoreOptions` and `UseGristCoreResult`, the connection types they build on. `GristWidgetStatus` is now a single type shared by `grist-widget-sdk` and `grist-widget-sdk/advanced`, where there used to be two identical ones. All additions are type-only. At runtime, `docApi` is now read from `window.grist` on every render instead of memoized on the handshake phase, so it can no longer outlive a `window.grist` that was replaced or removed (as the emulator does) while the phase stayed `online`; in real Grist the global never changes, so the value is the same.
+
 ## 0.3.17
 
 ### Patch Changes

package/dist/advanced.cjs

@@ -1699,11 +1699,7 @@ function useGristCoreFromManager(manager) {
   );
   const status = deriveStatus(snapshot);
   const error = deriveErrorMessage(snapshot);
-  const docApi = (0, import_react2.useMemo)(() => {
-    if (snapshot.lifecycle.phase !== "online") return null;
-    if (typeof grist === "undefined") return null;
-    return grist.docApi ?? null;
-  }, [snapshot.lifecycle.phase, snapshot.generation]);
+  const docApi = snapshot.lifecycle.phase === "online" && typeof grist !== "undefined" ? grist.docApi ?? null : null;
   const isAvailable = computeAvailabilityFromSnapshot(snapshot);
   const reload = (0, import_react2.useCallback)(async () => {
     manager.reload();