apprun 3.37.3 → 3.38.1

package/README.md

@@ -116,7 +116,7 @@ app.start(document.body, state, view);
 ```
 <apprun-code></apprun-code>
 
-And, of course, you can use Components to encapsulate the logic blocks, e.g., SPA pages. Each component can have its own state, view, and update functions. Each component has its own handlers to handle the routing events. AppRun routes `/<path>`, `#<path>`, and `#/<path>` URLs to components. AppRun also does this with [hierarchical routing](docs/requirements/req-hierarchical-routing.md).
+And, of course, you can use Components to encapsulate the logic blocks, e.g., SPA pages. Each component can have its own state, view, and update functions. Each component has its own handlers to handle routing events. Hash URLs work by default. To intercept ordinary `/<path>` links for SPA navigation, call `app.use_prettyLink()` before AppRun initializes. AppRun also supports [hierarchical routing](docs/requirements/req-hierarchical-routing.md).
 
 ```js
 class Home extends Component {
@@ -142,6 +142,7 @@ const App = () => <>
   <div id="pages"></div>
 </>
 
+app.use_prettyLink();
 app.render(document.body, <App />);
 [About, Contact, Home].map(C => new C().start('pages'));
 ```
@@ -286,4 +287,4 @@ Copyright (c) 2015-2025 Yiyi Sun
 [twitter-badge]: https://img.shields.io/twitter/url/https/github.com/yysun/apprun.svg?style=social
 
 [discord-image]: https://img.shields.io/discord/476903999023480842.svg
-[discord-invite]: https://discord.gg/CETyUdx
+[discord-invite]: https://discord.gg/CETyUdx

package/WHATSNEW.md

@@ -1,5 +1,29 @@
 ## What's New
 
+> July 13, 2026, V3.38.1
+
+### Routing compatibility
+
+AppRun again uses hash routing and normal browser navigation by default. Applications that intentionally use SPA `/path` links must opt into pretty-link routing before AppRun initializes:
+
+```js
+app.use_prettyLink();
+```
+
+This restores the explicit routing contract and prevents AppRun from intercepting ordinary same-origin links unless the application requests it.
+
+### Fixes
+
+- Fixed the first client render so stale server-rendered or loading classes are removed when the new vnode has null or undefined props.
+- Fixed Play by loading a pinned TypeScript browser runtime and running browser-global examples early enough for startup configuration such as `app.use_prettyLink()` to take effect.
+- Updated the README, CLI starter, standalone add-components demo, and Play routing examples for explicit pretty-link routing; also repaired the SVG xlink example.
+
+> July 26, 2025, V3.38.0
+
+- Improved `$bind` directive to support nested objects and arrays: [Effortless Two-Way Data Binding in Apprun with $bind](#docs/done/blog-bind-directive.md)
+- Support for type safe props and children in components: [Typed Props and Children](#docs/done/blog-typed-props-and-children.md)
+- Use `unknown` instead of `any` for generic defaults to enhance type safety: [Why `unknown` is better than `any`](#docs/done/blog-why-unknown-better-than-any.md)
+
 > July 22, 2025, V3.37.0
 
 - Introduced `createState` helper for simplified immutable state updates using Immer [create-state-immer](#docs/done/blog-create-state-immer.md)
@@ -27,10 +51,16 @@ Code review by using Copilot and Claude Sonnet 4, see [plan-apprun-bugfixes.md](
 > July 11, 2025, V3.35.0
 
 
-### Support auto use router for pretty links
+### Support routing with pretty links
 
 AppRun now supports pretty links. 
 
+Enable pretty-link routing before AppRun initializes:
+
+```js
+app.use_prettyLink();
+```
+
 ```html
 <a href="/about">About</a>
 ```
@@ -69,9 +99,7 @@ app.render(document.body, <App />);
 
 
 
-AppRun will catch the `'/about'` route as event and render the component that is subscribed to it.
-
-If you have components subscribe to '#', or '#/', Apprun will fallback to the hash-based routing.
+AppRun will catch the `'/about'` route as an event and render the component that is subscribed to it. Without the explicit opt-in, AppRun uses hash routing and leaves ordinary links to the browser.
 
 > July 6, 2025, V3.33.10
 
@@ -357,5 +385,3 @@ Published on Jul 2, 2017 · 5 min read
 
 * [Building Applications with AppRun, Part 1 - Getting Started](https://www.youtube.com/watch?v=RuRmXEN2-xI)
 * [Building Applications with AppRun, Part 2 - Components](https://www.youtube.com/watch?v=qkP6HvZmhtY)
-
-