sdx 1.0.0-alpha3

SDX 1.0.0-alpha3 introduces framework-agnostic hook cores under @sdx/core/*, a native dialog system replacing jQuery UI, preprocessor-agnostic SSR builds, and shared-chunk CSS auto-attachment. One breaking change: HtmlFragment now emits the marker class flatten instead of sdx-flatten.

Breaking changes

• HtmlFragment (React + Vue) now emits className="flatten" (previously sdx-flatten). Themes that style this marker class must update the selector. No change is needed in template authors' code.

Highlights

Framework-agnostic core layer

• @sdx/core/transport: apiCall, fetchDataProviderProps, SDX_HEADERS
• @sdx/core/mount: shared mount pipeline for React / Vue / Svelte
• @sdx/security: centralized CSRF handling
• @sdx/base/types: shared TS types (BlockProps, DrupalAttributes, ContextualLink, MenuItem, LocalTaskTab, ActionLink)
• Hook cores under sdx/js/core (drupal-settings, batch-polling, confirm-modal); useDeferredProps / useLazyProp ported to Vue and Svelte

Native dialog system

Replaces jQuery UI dialogs with an SDX-owned pipeline; async unsaved-changes guard.

SSR builds are now preprocessor-agnostic

• vite.config.ssr.js short-circuits .css / .scss / .sass / .less / .styl imports to no-ops. SSR bundles output HTML, not CSS.
• react-dom/client externalized in SSR. Prevents build failures when a client-only module (e.g. installDialogBridge) is statically imported from the component graph.
• Uninstalling sdx_sass no longer breaks drush sdx:ssr:build. CSR still resolves styles via the feature plugin system.

AutoLibraryGenerator: shared-chunk CSS

Discovers and attaches assets/[chunk].css siblings of Vite-emitted chunks/[chunk]-[hash].js. Primitives whose styles land in a shared chunk (Card, IconButton, Prose, LinkList, and so on) now load correctly.

Admin dashboard

New overview + packages DataProvider pages with pnpm tree audit.

TypeScript-first runtime

• runtime.ts converted to TypeScript (ESM compile path)
• sdx-navigate rewritten in TypeScript; dead registry removed
• sdx_typescript absorbed into sdx core; JSX ownership moved to sdx_react
• sdx-devel-toolbar ported to TypeScript; sdx-setup-wizard.js modernized to ES2020
• sdx_vue is now a thin hook-adapter layer over @sdx/core/* with HtmlFragment parity

Fixes

• Preserve DataProvider props on same-URL re-navigation
• Batch: redirect detection, null-safe state restoration, translated modal strings, innerHTML for server-rendered HTML labels
• ConfirmModalStore: SSR-safe construction + getServerSnapshot
• spreadAttributes: normalize style strings to React style objects
• form_action tokens resolve to canonical path inside confirm forms
• interpretStyleProcessor emits both loadPaths (modern-compiler) and includePaths (legacy) for sass-embedded API switching
• Promoted Badge, EmptyState, ToggleSwitch to framework _shared/ui

Internal

• sdx_router forwards ajax_page_state[libraries] to prevent window.Drupal wipe
• sdx_react: server-only token contract; sdx_ssr owns its own page-render injection
• SSR: framework-renderer.mjs now lives under private/sdx
• Full PHPCS / PHPStan level 0 clean; PHPUnit 176/176 green
• BuildOutputResolver: central vs distributed build output modes
• Import map emitted server-side via ImportMapBuilder
• AJAX interceptor consolidated across frameworks

Full changelog: CHANGELOG.md