grist-widget-sdk 0.3.25 → 0.3.26

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # grist-widget-sdk
 
+## 0.3.26
+
+### Patch Changes
+
+- acc1501: New entry point, `grist-widget-sdk/app`: `mountGristWidget({ App, options, dev })` does what a widget's `src/main.tsx` used to wire by hand.
+  
+  - **Inside Grist** it renders the widget in `GristWidgetProvider` and `GristBoundary`, gated on mapped columns when the widget declares any, with the SDK's alerts above it (column mapping, access level, failed writes, an unlinked section). `App` may be a `React.lazy()` component, so a heavy widget's code loads only inside Grist.
+  - **Outside Grist** it shows a local-dev page on the dev server, pointing at `pnpm test` and the `dev` loop, and a release page on a deployed URL, linking every channel and version with the URL to paste into Grist. Both are named after the page's `<title>`.
+  - **The theme**: inside Grist the widget now follows Grist's light/dark theme (the OS setting until Grist sends it); outside Grist the OS setting applies, a choice made with `setTheme()` is saved, and the `d` key switches themes, as shadcn's theme provider does. `useTheme()` has the shape of shadcn's, for components such as a toaster.
+  
+  The pages and alerts read shadcn's CSS variables (`--background`, `--foreground`, `--border`, `--radius`, …) with neutral fallbacks, so they follow a widget's theme without depending on its Tailwind config, and each one is replaceable (`Alerts`, or `Alerts: null`; `LocalDevPage`; `ReleasePage`). They only surround the widget: the SDK still styles nothing inside it. `<GristWidgetApp>` is the same tree as a component, for tests, and `parseDeployPath()`, `deployChannelLabel()` and `useReleasedVersions()` serve a custom release page.
+
 ## 0.3.25
 
 ### Patch Changes

package/dist/advanced.d.cts

@@ -1,9 +1,10 @@
-import { ab as GristTerminationReason, ac as GristGeneration, ad as GristMappingSource, G as GristWidgetSnapshot, d as GristCapabilities } from './use-grist-widget-options-from-context-Bbd5-f39.cjs';
+import { a8 as GristTerminationReason, a9 as GristGeneration, aa as GristMappingSource, G as GristWidgetSnapshot, c as GristCapabilities } from './use-grist-reads-DpjVuI0H.cjs';
 import { UseGristCoreOptions, GristWidgetStatus, GristUserActionTuple, GristAccessToken, GristColumnarTable } from './index.cjs';
-export { ae as GristAuthz, h as GristColumnInfo, af as GristConfig, ag as GristCurrentTableState, ah as GristLifecycle, ai as GristLifecyclePhase, aj as GristLink, ak as GristLinkState, al as GristMappingComplete, am as GristMappingIncomplete, an as GristMappingState, ao as GristStreamFreshness, ap as GristSync, g as ListColumnsOptions, L as ListTablesOptions, v as UseGristWidgetOptionsFromContextConfig, w as UseGristWidgetOptionsFromContextResult, aa as useGristWidgetOptionsFromContext } from './use-grist-widget-options-from-context-Bbd5-f39.cjs';
+export { ab as GristAuthz, e as GristColumnInfo, ac as GristConfig, ad as GristCurrentTableState, ae as GristLifecycle, af as GristLifecyclePhase, ag as GristLink, ah as GristLinkState, ai as GristMappingComplete, aj as GristMappingIncomplete, ak as GristMappingState, al as GristStreamFreshness, am as GristSync, L as ListColumnsOptions, r as ListTablesOptions } from './use-grist-reads-DpjVuI0H.cjs';
 import { GristRequiredAccess, GristColumnsToMap, GristWidgetColumnMap, GristReadyOptions, GristDocApi, GristApplyUserActionsOptions, GristTableNewRecord, GristTableOpOptions, GristMinimalRecord, GristTableUpdateRecord, GristTableUpsertRecord, GristTableUpsertOptions, GristRowRecord, GristFetchSelectedOptions } from './index.cjs';
 import * as react from 'react';
 import { ReactNode } from 'react';
+export { U as UseGristWidgetOptionsFromContextConfig, a as UseGristWidgetOptionsFromContextResult, u as useGristWidgetOptionsFromContext } from './use-grist-widget-options-from-context-CGOlQ5Vc.cjs';
 import 'zod';
 
 /**

package/dist/advanced.d.ts

@@ -1,9 +1,10 @@
-import { ab as GristTerminationReason, ac as GristGeneration, ad as GristMappingSource, G as GristWidgetSnapshot, d as GristCapabilities } from './use-grist-widget-options-from-context-hl-NwOwP.js';
+import { a8 as GristTerminationReason, a9 as GristGeneration, aa as GristMappingSource, G as GristWidgetSnapshot, c as GristCapabilities } from './use-grist-reads-DUMvJgV7.js';
 import { UseGristCoreOptions, GristWidgetStatus, GristUserActionTuple, GristAccessToken, GristColumnarTable } from './index.js';
-export { ae as GristAuthz, h as GristColumnInfo, af as GristConfig, ag as GristCurrentTableState, ah as GristLifecycle, ai as GristLifecyclePhase, aj as GristLink, ak as GristLinkState, al as GristMappingComplete, am as GristMappingIncomplete, an as GristMappingState, ao as GristStreamFreshness, ap as GristSync, g as ListColumnsOptions, L as ListTablesOptions, v as UseGristWidgetOptionsFromContextConfig, w as UseGristWidgetOptionsFromContextResult, aa as useGristWidgetOptionsFromContext } from './use-grist-widget-options-from-context-hl-NwOwP.js';
+export { ab as GristAuthz, e as GristColumnInfo, ac as GristConfig, ad as GristCurrentTableState, ae as GristLifecycle, af as GristLifecyclePhase, ag as GristLink, ah as GristLinkState, ai as GristMappingComplete, aj as GristMappingIncomplete, ak as GristMappingState, al as GristStreamFreshness, am as GristSync, L as ListColumnsOptions, r as ListTablesOptions } from './use-grist-reads-DUMvJgV7.js';
 import { GristRequiredAccess, GristColumnsToMap, GristWidgetColumnMap, GristReadyOptions, GristDocApi, GristApplyUserActionsOptions, GristTableNewRecord, GristTableOpOptions, GristMinimalRecord, GristTableUpdateRecord, GristTableUpsertRecord, GristTableUpsertOptions, GristRowRecord, GristFetchSelectedOptions } from './index.js';
 import * as react from 'react';
 import { ReactNode } from 'react';
+export { U as UseGristWidgetOptionsFromContextConfig, a as UseGristWidgetOptionsFromContextResult, u as useGristWidgetOptionsFromContext } from './use-grist-widget-options-from-context-CGOlQ5Vc.js';
 import 'zod';
 
 /**