solara-ui 1.45.0__py3-none-any.whl

solara/website/pages/changelog/changelog.md

@@ -0,0 +1,372 @@
+# Solara Changelog
+
+## Version 1.44.0
+
+   * Feature: Separate `disable_send` and `disable_input` to allow typing but not sending or vice versa for the `ChatInput` component. [86fc2ad](https://github.com/widgetti/solara/commit/86fc2ad88a89ffe134eaa6700a8c416bcab036b4).
+   * Feature: Support `autofocus` for the `ChatInput` component. [31dad76](https://github.com/widgetti/solara/commit/31dad767c15e3671e610fcba5ae2b124bb0b5220).
+   * Feature: Allow websocket messages to be sent from main thread. [#953](https://github.com/widgetti/solara/pull/953).
+   * Bug Fix: Typing for `memoize`'s `key` was incorrect. [#959](https://github.com/widgetti/solara/pull/959).
+   * Bug Fix: Using `get_ipython` outside Solara's virtual kernels after importing Solara would return `None`. [#990](https://github.com/widgetti/solara/pull/990).
+   * Bug Fix: Solara lab components (and perhaps others) didn't work when used in Jupyter contexts. [#981](https://github.com/widgetti/solara/pull/981).
+   * Bug Fix: Threaded and async tasks behaving differently when cancelling. [5fe30dc](https://github.com/widgetti/solara/commit/5fe30dc27fe99ee056f3a046c0942386b181d00f).
+   * Bug Fix: Fixes to handling context for reactive variable subscription / event handling. [06f1670](https://github.com/widgetti/solara/commit/06f1670bc918231897d4e5dcb00374711fc83464), [4ff39c5](https://github.com/widgetti/solara/commit/4ff39c5647057db53788c925139a710ab045897b).
+   * Bug Fix: Running a Solara app under FastAPI / Starlette was broken. [133e2ca](https://github.com/widgetti/solara/commit/133e2cab13efe4277f98305cdba412c08b47936f).
+   * Bug Fix: Allow reactive variables to be set from outside kernel context. [#952](https://github.com/widgetti/solara/pull/952).
+   * Bug Fix: Do not ignore all errors on websocket disconnect. [1f6d98e](https://github.com/widgetti/solara/commit/1f6d98e2b5233116cc617cf7d9019d2748ba251d).
+   * Bug Fix: Enable `dense` option for SelectMultiple. [#939](https://github.com/widgetti/solara/pull/939).
+
+## Version 1.43.0
+   * Feature: Time picker component. [#654](https://github.com/widgetti/solara/pull/654).
+   * Feature: Make the default container of sibling components configurable. By default the setting remains the same (using `solara.Column`), but will default to `reacton.Fragment` in Solara 2.0 (see [the roadmap](/roadmap)). Can be changed by setting the `SOLARA_DEFAULT_CONTAINER` environmental variable to the name of a component (e.g. `"Column"`). [#928](https://github.com/widgetti/solara/pull/928).
+   * Feature: Do not allow reactive to be used in boolean comparisons. This feature is turned off by default, and can be enabled by setting the `SOLARA_ALLOW_REACTIVE_BOOLEAN=1` environmental variable. This feature will be enabled by default starting in Solara 2.0, see [the roadmap](/roadmap). [#846](https://github.com/widgetti/solara/pull/846).
+   * Feature: Use index for row names of pandas dataframes. [#613](https://github.com/widgetti/solara/pull/613).
+   * Feature: Support setting `http_only` for Solara session cookie. [#876](https://github.com/widgetti/solara/pull/876).
+   * Feature: Allow disabling notebook extensions. [#842](https://github.com/widgetti/solara/pull/842).
+   * Feature: `custom_exceptions` is now defined in `FakeIPython`. [#839](https://github.com/widgetti/solara/pull/839).
+   * Bug Fix: `InputDate` would not accept values if format was changed. [#933](https://github.com/widgetti/solara/pull/933).
+   * Bug Fix: Close kernels when ASGI/Starlette server is shut down. [#930](https://github.com/widgetti/solara/pull/930).
+   * Bug Fix: Avoid and test for the existence of memory leaks. [#377](https://github.com/widgetti/solara/pull/377).
+   * Bug Fix: `send_text` sent bytes instead of string. [637a77f](https://github.com/widgetti/solara/commit/637a77f2539ee68555cf998313aee62cde802579).
+   * Bug Fix: Avoid solara run hanging because of PyPI version request. [#855](https://github.com/widgetti/solara/pull/855).
+   * Bug Fix: Catch exceptions raised by startlette on websocket send failure. [7e50ee7](https://github.com/widgetti/solara/commit/7e50ee7edb7a36644b02d9d80ae91e1ac292975e).
+   * Bug Fix: Numpy scalars were erroneously converted to a string instead of a number. [cffccca](https://github.com/widgetti/solara/commit/cffccca500c36e21357323168b73ddd716071885).
+   * Bug Fix: Failing websocket.send calls would suppress all errors. [51cbfa9](https://github.com/widgetti/solara/commit/51cbfa970d42e5ff2c2b25de268e951677013467).
+
+## Version 1.42.0
+   * Feature: Mutation detection is now available under the `SOLARA_STORAGE_MUTATION_DETECTION` environmental variable. [#595](https://github.com/widgetti/solara/pull/595).
+   * Feature: Autofocusing text inputs is now supported. [#788](https://github.com/widgetti/solara/pull/788).
+   * Feature: Custom colours are now supported for the Solara loading spinner. [#858](https://github.com/widgetti/solara/pull/858)
+   * Bug Fix: Echarts responsive size is now properly supported. [#273](https://github.com/widgetti/solara/pull/273).
+   * Bug Fix: Some version checks would prevent Solara from starting. [#904](https://github.com/widgetti/solara/pull/904).
+   * Bug Fix: Solara apps running in qt mode (`--qt`) should now always work correctly. [#856](https://github.com/widgetti/solara/pull/856).
+   * Bug Fix: Hot reloading of files outside working directory would crash app. [069a205](https://github.com/widgetti/solara/commit/069a205c88a8cbcb0b0ca23f4d56889c8ad6134a) and [#869](https://github.com/widgetti/solara/pull/869).
+
+## Version 1.41.0
+   * Feature: Support automatic resizing of Altair (Vega-Lite) figures. [#833](https://github.com/widgetti/solara/pull/833).
+   * Feature (Experimental): Support running Solara applications as standalone QT apps. [#835](https://github.com/widgetti/solara/pull/835).
+   * Feature: Add option to hide "This website runs on Solara"-banner. [#836](https://github.com/widgetti/solara/pull/836).
+   * Feature: Support navigating to hashes. [#814](https://github.com/widgetti/solara/pull/814).
+   * Bug Fix: Chunks and assets in nbextensions would fail to load. [9efe26c](https://github.com/widgetti/solara/commit/9efe26cbe00210163a6e8ef251ebfe50ca87fce2).
+   * Bug Fix: Vue widget decorator now always uses absolute paths. [#826](https://github.com/widgetti/solara/pull/826).
+
+## Version 1.40.0
+   * Feature: In Jupyter Notebook and Lab, Solara (server) now renders the [ipypopout](https://github.com/widgetti/ipypopout) window instead of Voila [#805](render ipypopout content in jupyter notebook and lab)
+   * Feature: Support styling input field of [ChatInput component](https://solara.dev/documentation/components/lab/chat). [#800](https://github.com/widgetti/solara/pull/800).
+   * Feature: [InputTextArea component](https://solara.dev/documentation/components/input/input) for multi line text input. [#801](https://github.com/widgetti/solara/pull/801). Contributed by [Alonso Silva](https://github.com/alonsosilvaallende)
+   * Bug Fix: Markdown links triggered a JavaScript error. [#765](https://github.com/widgetti/solara/pull/765)
+
+## Version 1.39.0
+
+   * Feature: Add option to start Solara server on a random unused port (using `--port=0`). [#762](https://github.com/widgetti/solara/pull/762)
+   * Bug Fix: Extension checking for e.g. ipyleaflet now work correctly on Amazon SageMaker Studio Lab. [#757](https://github.com/widgetti/solara/pull/757)
+   * Bug Fix: Various solara components should now work correctly in notebooks viewed on vscode, colab and voila. [#763](https://github.com/widgetti/solara/pull/763)
+
+## Version 1.38.0
+
+   * Feature: We detect and warn when there are possible reverse proxy or uvicorn misconfigurations. [#745](https://github.com/widgetti/solara/pull/745)
+   * Bug Fix: Auth redirect did not respect SOLARA_BASE_URL. [#747](https://github.com/widgetti/solara/pull/747)
+   * Bug Fix: Support for `websockets >= 13.0` and large cookies. [#751](https://github.com/widgetti/solara/pull/751)
+   * Bug Fix: Windows support was broken from version 1.35.0 to 1.37.2. This went undetected due to a CI configuration error. [#712](https://github.com/widgetti/solara/pull/712) [#739](https://github.com/widgetti/solara/pull/739)
+
+## Version 1.37.2
+
+   * Bug Fix: If matplotlib was imported before solara, we did not set the backend, now we do. [#741](https://github.com/widgetti/solara/pull/741)
+
+## Version 1.37.1
+
+   * Bug Fix: The newly introduced hooks validator could emit a warning on certain call syntax. This can fail CI pipelines that do now allow warnings [c7c3b6a](https://github.com/widgetti/solara/commit/c7c3b6ab2929c4da1ffc3ab8e2e423cf0cfa7567).
+
+## Version 1.37.0
+
+   * Feature: We now check if a component follows the rules of hooks https://solara.dev/documentation/advanced/understanding/rules-of-hooks [#706](https://github.com/widgetti/solara/pull/706)
+
+      Use SOLARA_CHECK_HOOKS=off to disable this check in case this gives unexpected issues, [and please open an issue](https://github.com/widgetti/solara/issues/new).
+   * Fix: solara-server skips directories when reading extensions which might cause a startup failure otherwise [#715](https://github.com/widgetti/solara/pull/715)
+
+## Version 1.36.0
+   * Feature: Provide a jupyter-widgets-popout-container css class on body for doing specific styling in combination with ipypoout [85c1899](https://github.com/widgetti/solara/commit/85c189919a42b2590558d9713fc3a2440f46b7c0)
+
+## Version 1.35.1
+
+   * Bug Fix: Vulnerability which allowed for accessing any file on the system. [CVE-2024-39903](https://nvd.nist.gov/vuln/detail/CVE-2024-39903)
+     [391e212](https://github.com/widgetti/solara/commit/391e2124a502622fe7a04321a540af6f252d8d4b).
+   * Bug Fix: On windows we now read all text files (like CSS) with utf8 encoding by default [681f69b](https://github.com/widgetti/solara/commit/681f69b7779da2bd3586d6e9fd0b21d36e6fb124)
+
+
+## Version 1.35.0
+
+   * Feature: On slower systems, pytest-ipywidgets could time out when connecting to the app, `PYTEST_IPYWIDGETS_SOLARA_APP_WAIT_TIMEOUT` can be set to increase the timeout. [c302caf](https://github.com/widgetti/solara/commit/c302caf520b6bd4825f4104ac4d629b1d9543607) and [Our testing docs](https://solara.dev/documentation/advanced/howto/testing).
+   * Bug Fix: The sidebar container did not have `height: 100%` set, causing the sidebar to not fill the entire height of the page. [5358f0f](https://github.com/widgetti/solara/commit/5358f0f1b8582422041bfc6553e6d95e103a9aa9)
+   * Bug Fix: Vulnerability which allowed for accessing any file on the system. [CVE-2024-39903](https://nvd.nist.gov/vuln/detail/CVE-2024-39903)
+     [391e212](https://github.com/widgetti/solara/commit/391e2124a502622fe7a04321a540af6f252d8d4b). A follow up fix was need for this in 1.35.1, we recommend upgrading to that version.
+   * Bug Fix: Allow the FileBrowser to navigate to the root on Windows [707](https://github.com/widgetti/solara/pull/707) - Contributed by Jochem Smit.
+
+## Version 1.34.1
+
+   * Bug Fix: Using `SOLARA_ASSETS_PROXY=False` (default on [py.cafe](https://py.cafe)) would break grid layout. [#705](https://github.com/widgetti/solara/pull/705)
+   * Bug Fix: Hot reload work in more situations on Linux. [#702](https://github.com/widgetti/solara/pull/702)
+
+
+## Version 1.34.0
+
+   * Feature: Enhancements for Solara `InputDate` and `InputDateRange` components [#672](https://github.com/widgetti/solara/pull/672):
+      * Limiting allowed dates with `min_date` and `max_date` arguments.
+      * Monthly granularity with `date_picker_type="month"`.
+      * `InputDateRange` selection can be sorted in ascending order with `sort` argument.
+   * Bug Fix: Typo in `solara.Tooltip`. [#695](https://github.com/widgetti/solara/pull/695)
+   * Bug Fix: `ipywidgets.Accordion` content was not hidden when closed. [#694](https://github.com/widgetti/solara/pull/694)
+   * Bug Fix: `solara.Tooltip` would break any functionality in it's children that relied on the `blur`, `keydown`, or `focus` events. [#696](https://github.com/widgetti/solara/pull/696)
+   * Bug Fix: Raise an error instead of showing a custom page on 404. Enables custom 404 pages in Solara apps. [#670](https://github.com/widgetti/solara/pull/670)
+   * Bug Fix: Prevent broken installation by restricting Numpy version. [#687](https://github.com/widgetti/solara/pull/687) and [`286e196`](https://github.com/widgetti/solara/commit/286e196ee990af814768d0612b98b5138f5ceb51).
+
+## Version 1.33.0
+
+### Details
+
+   * Feature: Add support for `color` argument to `solara.Switch`. [#658](https://github.com/widgetti/solara/pull/658)
+   * Bug Fix: Support `define` for ES Modules when running with virtual kernel. [#668](https://github.com/widgetti/solara/pull/668)
+   * Bug Fix: Typo in `NameError` message. [#666](https://github.com/widgetti/solara/pull/666)
+   * Bug Fix: Show `solara.AppBar` when navigation tabs are the only child. [#656](https://github.com/widgetti/solara/pull/656)
+   * Bug Fix: PermissionError for nbextensions on startup in `solara>=1.29`. [#648](https://github.com/widgetti/solara/pull/648)
+
+## Version 1.32.2
+
+### Details
+
+   * Bug Fix: Theme change not behaving correctly for `solara.Markdown` and `ipywidgets`. [#636](https://github.com/widgetti/solara/pull/636)
+
+
+## Version 1.32.1
+
+### Details
+
+   * Bug Fix: `solara.display` not working when running a solara server in production mode, or when running a Solara app with flask. [#622](https://github.com/widgetti/solara/pull/622)
+   * Bug Fix: `solara.Markdown` would raise a `NameError` if `pymdown-extensions` was not installed. [#621](https://github.com/widgetti/solara/pull/621)
+
+
+## Version 1.32.0
+
+### Details
+
+   * Feature: Support for multiple custom asset locations. [#602](https://github.com/widgetti/solara/pull/602)
+   * Refactor: Improve API for working with third-party dataframes. [#600](https://github.com/widgetti/solara/pull/600)
+   * Bug Fix: Give task results more unique keys. [#609](https://github.com/widgetti/solara/pull/609)
+   * Bug Fix: Avoid closing kernel multiple times. [e5ca67b](https://github.com/widgetti/solara/commit/e5ca67b6be46a8d236cc127cc06068702aa40754)
+   * Bug Fix: Make `page_close` beacon thread safe. [2501c83](https://github.com/widgetti/solara/commit/2501c83f135bc342ed9845198f7aff3bdcf09bc0)
+   * Bug Fix: Viewing embedded Solara application in fullscreen could cause a Reacton error. [#603](https://github.com/widgetti/solara/pull/603)
+   * Bug Fix: Remove fade when navigation is done from a thread/task. [#594](https://github.com/widgetti/solara/pull/594)
+   * Bug Fix: Support Pydantic 1 and 2 in reactive variables. [#601](https://github.com/widgetti/solara/pull/601)
+
+## Version 1.31
+
+We changed solara from a single package into multiple packages.
+
+The `solara` package is a meta package that installs all the necessary dependencies to get started with Solara. By default, we install:
+
+  * [`pip install "solara-ui[all]"`](https://pypi.org/project/solara-ui)
+  * [`pip install "solara-server[starlette,dev]"`](https://pypi.org/project/solara-ui)
+
+Notebook users can simply install `solara-ui` if they do not need the solara-server. Read our [installation guide](https://solara.dev/documentation/getting_started/installing) for more information.
+
+## Version 1.30.1
+
+### Details
+
+   * Bug Fix: Serialization error from attempt to serialize default event handles in `component_vue`. [793cbb1](https://github.com/widgetti/solara/commit/793cbb19d8c361490b7e0b1e436a3e9ef3acea71)
+   * Bug Fix: `on_kernel_start` callback cleanups could have been triggered multiple times. [4b75ca9](https://github.com/widgetti/solara/commit/4b75ca934f4e905a3592911bfca6657e491d1425)
+   * Bug Fix: Autorender did not render child routes. [#575](https://github.com/widgetti/solara/pull/575)
+
+
+## Version 1.30.0
+
+### Details
+
+   * Feature: Multiple file support for `FileDrop`. [#562](https://github.com/widgetti/solara/pull/562)
+   * Feature: Solara server is now compatible with Pyodide (threads are combined if they cannot be used). [#569](https://github.com/widgetti/solara/pull/569)
+   * Bug Fix: Nested Vuetify apps were not displayed correctly. [#570](https://github.com/widgetti/solara/pull/570)
+   * Bug Fix: `on_kernel_start` callbacks were accumulating on hot reload. [#556](https://github.com/widgetti/solara/pull/556)
+   * Bug Fix: ES Modules were being loaded multiple times on hot reload. [#559](https://github.com/widgetti/solara/pull/559)
+   * Bug Fix: Theme CSS was not loaded when `rootPath` was non-trivial. [829946c](https://github.com/widgetti/solara/commit/829946c4bf47a2ea78d783bb500faaab93b2549b)
+   * Fix: `Route.component` is now rendered, instead of the internal `RenderPage` component. [#555](https://github.com/widgetti/solara/pull/555)
+   * Fix: `Route.layout` now allows for layouts to be used when defining routes manually. [#554](https://github.com/widgetti/solara/pull/554)
+   * Fix: Allow custom command like arguments that can be parsed by the application. [#558](https://github.com/widgetti/solara/pull/558)
+
+
+## Version 1.29.1
+
+### Details
+
+   * Bug Fix: Solara installation failing when using [pixi](https://pixi.sh/latest/). [#553](https://github.com/widgetti/solara/pull/553)
+
+## Version 1.29.0
+
+<video width="80%" controls>
+   <source src="https://solara-assets.s3.us-east-2.amazonaws.com/videos/solara-1.29-drawdata-na.mp4" type="video/mp4" >
+</video>
+
+
+### Highlights
+
+  * Feature: Improved matplotlib support (pylab interface, display support) making it work more similar as in Jupyter. [#540](https://github.com/widgetti/solara/pull/540)
+  * Feature: [use_dark_effective](https://solara.dev/api/use_dark_effective) to get the effective dark mode of the app, making it easier to support dark mode on the Python side [#551](https://github.com/widgetti/solara/pull/551).
+
+
+### Details
+
+   * Feature: [`/resourcez` endpoint](https://solara.dev/docs/understanding/solara-server) to get server resource statistics [#547](https://github.com/widgetti/solara/pull/547).
+   * Bug fix: router.push to external links should not use history, allowing navigation to external links [11c6094](https://github.com/widgetti/solara/commit/11c6094f3c47528d40f8be951c1d322e454f98ea).
+   * Bug fix: After upgrading widgets, solara server would still use the previous version due to browser cache [#523](https://github.com/widgetti/solara/pull/523).
+   * Bug fix: [The example todo app](https://solara.dev/examples/utilities/todo) would not work because Ref(..) did not work in combination with use_reactive [#544](https://github.com/widgetti/solara/pull/544).
+
+## Version 1.28.0
+
+<video width="80%" controls>
+   <source src="https://dxhl76zpt6fap.cloudfront.net/videos/solara-theme.mp4"  type="video/mp4" >
+</video>
+
+### Highlight
+
+   * Feature: [Theming support](https://solara.dev/api/theming), including dark theme and auto-detection of device preference [#494](https://github.com/widgetti/solara/pull/494).
+
+### Details
+
+   * Feature: Support for [ES modules](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules) using [ipyReact](https://github.com/widgetti/ipyreact)
+      [#516](https://github.com/widgetti/solara/pull/516).
+   * Feature: Support for [Polars](https://pola.rs/) dataframes in `solara.DataFrame` [#195](https://github.com/widgetti/solara/pull/195)
+   * Bug Fix: User reactive variables sometimes taking on the value of a solara builtin one (issue [#510](https://github.com/widgetti/solara/issues/510))
+      [#514](https://github.com/widgetti/solara/pull/514)
+   * Bug Fix: An extra scrollbar sometimes appearing when no `AppBar` or `SideBar` was present on the page [#477](https://github.com/widgetti/solara/pull/477)
+   * Bug Fix: The browser main scrollbar being present on pages with no scrolling enabled [#518](https://github.com/widgetti/solara/pull/518)
+
+## Version 1.27.0
+
+
+<video width="80%" controls>
+   <source src=https://dxhl76zpt6fap.cloudfront.net/videos/solara-tasks.mp4  type="video/mp4" >
+</video>
+
+### Highlight
+
+   * Feature: [Task support](https://solara.dev/api/task). Lets you run code in the background, with the UI available to the user. This is useful for long running tasks, like downloading data or processing data [#461](https://github.com/widgetti/solara/pull/461).
+   * Feature: Provide access to [cookies and request headers](https://solara.dev/api/cookies_headers) [#501](https://github.com/widgetti/solara/pull/501)
+   * Refactor: Replace MathJax with KaTeX for faster math rendering and a lighter package [#483](https://github.com/widgetti/solara/pull/483)
+
+## Version 1.26.0
+
+### Demo of @solara.lab.computed with
+
+<video width="80%" controls>
+   <source src="https://github.com/widgetti/solara/assets/5592797/daf21bb0-ce94-4d5e-9ebb-339ea768b3ac" type="video/mp4" >
+</video>
+
+### Highlight
+
+   * Feature: [computed reactive variables](https://solara.dev/api/computed) which use the return value of the function. The value will be updated when any of the reactive variables used in the function [#455](https://github.com/widgetti/solara/pull/455).
+
+### Details
+
+   * Feature: on_kernel_start triggers callback on virtual kernel start [#471](https://github.com/widgetti/solara/pull/471).
+   * Bug fix: Altair works in VSCode and Google Colab [#488](https://github.com/widgetti/solara/pull/488).
+   * Feature: get_kernel_id and get_session_id for custom storage [#452](https://github.com/widgetti/solara/pull/452).
+   * Bug fix: Mermaid and Math rendering in Jupyter Lab and VSCode [#480](https://github.com/widgetti/solara/pull/480).
+
+## Version 1.25.1
+
+### Details
+
+* Performance: Removed unnecessary CSS and JS.
+* Performance: Quality of Life - JS and CSS resources automatically reloaded on version change.
+* Bug fix: overlay disabling navigation for display width < 960px.
+
+
+## Version 1.25.0
+
+
+### Demo of a Chat GPT interface with medical 3d visualization
+
+<video width="80%" controls>
+   <source src="https://github.com/widgetti/solara/assets/1765949/ca149ab5-0bd3-4eea-9736-08e1e0b06771" type="video/mp4" >
+</video>
+
+
+
+
+### Highlight
+
+ * Feature: Chat interface components for chatbots, chatrooms or conversational elements in your dashboards or apps [#384](https://github.com/widgetti/solara/pull/384)
+
+### Details
+
+ * Performance: Under starlette, we throttle sending websocket messages to get better performance, this is experimental and can be enabled by setting the
+   environment variable `SOLARA_EXPERIMENTAL_PERFORMANCE=1` [#400](https://github.com/widgetti/solara/pull/400)
+ * Performance: Reuse the jinja environment when rendering templates (this also saves memory).
+
+## Version 1.24.0
+
+### Demo of CSS hot reloading
+
+<video width="80%" controls>
+   <source src="https://github.com/widgetti/solara/assets/1765949/3a15b8fa-f38e-4376-ad05-330593d98de8" type="video/mp4" >
+</video>
+
+
+### Highlight
+
+ * Feature: Hot reloading of css file used with Style components [#396](https://github.com/widgetti/solara/pull/396)
+ * Bug fix: display() did not work in threads [#398](https://github.com/widgetti/solara/pull/398)
+ * Bug fix: Support home directory on Windows.
+
+
+### Details
+
+ * Bug fix: Do not trigger re-render due to unneeded state in context [#386](https://github.com/widgetti/solara/pull/386)
+ * Feature: Show number of widgets created and close when using --timing [#387](https://github.com/widgetti/solara/pull/387)
+
+
+## Version 1.23.0
+
+### Demo app 'TimeTrekker'
+
+<video width="80%" controls>
+   <source src="https://github.com/widgetti/solara/assets/1765949/17598728-0678-495b-955a-965ce9283200" type="video/mp4" >
+</video>
+
+### Demo app 'Wanderlust'
+
+<video width="80%" controls>
+   <source src="https://github.com/widgetti/wanderlust/assets/1765949/fe3db611-4f46-4ca3-b4c2-ace6d2b1493b" type="video/mp4" >
+</video>
+
+
+### Highlights
+
+ * Feature: Solara now has a production mode (enabled by passing in `--production`) which will load optimized CSS and JS and disable hot reloading.
+    Our [Solara server](https://solara.dev/documentation/advanced/understanding/solara-server) page contains more information about it. If you used `--reload` or
+    `--dev` before you can now use the `-a/--auto-restart` flat. The `--dev` and `--reload` flags are kept for backwards compatibility.
+ * Feature: All `Input` components expose the `style` and `classes` arguments for custom styling.
+ * Feature: New component: [`InputDate` and `InputDateRange`](https://solara.dev/api/input_date) which use a datepicker in a menu. (#326)
+ * Feature: The AppLayout component exposes the `style` and `classes` argument for custom styling: [#367](https://github.com/widgetti/solara/pull/367)
+ * Feature: Initial support for ipyvue and ipyvuetify v3: [#364](https://github.com/widgetti/solara/pull/364)
+ * Feature: The `InputText` now takes an `update_events` on argument for custom key combination. This also allows to opt-out of the 'blur' event triggering an on_value: [#376](https://github.com/widgetti/solara/pull/376)
+ * Bug fix: When using a Sidebar or AppBar we would previously render the main `Page` component twice, this does not happen anymore: [#366](https://github.com/widgetti/solara/pull/366)
+ * Documentation: Added a "Jupyter dashboard tutorial" part 1.
+ * Documentation: Added documentation for [`use_effect`](https://solara.dev/api/use_effect), [`use_memo`](https://solara.dev/api/use_effect), and improved the documentation of [`use_thread`](https://solara.dev/api/use_thread).
+ * Example: Added an [AI tokenizer app example](https://solara.dev/examples/ai/tokenizer)
+ * Showcase: Added a reproduction of the [OpenAI Wanderlust app](https://solara.dev/showcase) to our showcases.
+
+
+### Details
+
+ * Feature: Menu supports use_activator_width argument, which can be set to false to not have the menu popup be the same with as the activator which is useful for fixed width components such as a date picker.
+ * Feature:
+ * Bug fix: Menu component avoids an extra div around the activator to not interfere with the layout: [#345](https://github.com/widgetti/solara/pull/345)
+ * Bug fix: Menu could be closed or opened on a re-render.
+ * Bug fix: Solara server failed to start in Docker when $HOME is not set or not writable.
+ * Bug fix: Solara server should only try to watch files that exists for hot reloading: [#356](https://github.com/widgetti/solara/pull/356)
+ * Bug fix: A ToggleButtons component using Buttons with `value=None` would cast it to a string (i.e. `value="None"`) : [#369](https://github.com/widgetti/solara/pull/369)
+ * Bug fix: PyTest based tests using vue_component_registry would fail outside of solara context, tests should run normally now.
+ * Bug fix: Our monkeypatched Output widget would raise an exception when `get_ipython` returns None such as in pytest based testing.
+ * Bug fix: A custom `Layout` component was ignored when running solara as a module: [#368](https://github.com/widgetti/solara/pull/368)
+ * Bug fix: A custom title was ignored when running solara as a script.
+ * Bug fix: When a child component would overrwrite a meta tags, it now overwrites it.
+ * Bug fix: do not use excessive memory when rendering markdown: [#382](https://github.com/widgetti/solara/pull/382)

solara/website/pages/contact/__init__.py

@@ -0,0 +1,34 @@
+import solara
+from solara.website.components.sidebar import Sidebar
+from solara.website.components.contact import Contact
+
+Sidebar = Sidebar
+
+
+@solara.component
+def Page():
+    solara.Markdown("""
+# Contact
+
+## Business
+
+Solara is developed mostly by Maarten Breddels and Mario Buikhuizen, Founders
+of [Widgetti](https://widgetti.io/).
+
+For business inquiries, please reach out using the form below, or send an email to [contact@solara.dev](mailto:contact@solara.dev) regarding Solara, or [info@widgetti.io](mailto:info@widgetti.io) regarding more general Jupyter related matters.
+""")
+    Contact(
+        title="Contact Us", subtitle="Please fill out the form below and we will get back to you as soon as possible.", email_subject="Contact Form Submission"
+    )
+    solara.Markdown(
+        """
+## Community
+
+If you want to share your thoughts, share your experiences, or just want to talk
+to other people using and developing on Solara, consider using [GitHub discussions](https://github.com/widgetti/solara/discussions) for asynchronous discussions
+or consider joining discord for more synchronous discussions.
+
+
+[![Discord Shield](https://discordapp.com/api/guilds/1106593685241614489/widget.png?style=banner2)](https://discord.gg/dm4GKNDjXN)
+"""
+    )

solara/website/pages/doc_use_download.py

@@ -0,0 +1,85 @@
+# flake8: noqa
+import solara
+import solara as sol
+from solara.alias import rv, rw
+
+from .docutils import IncludeComponent
+
+file_path = "yolov3.weights"
+url = "https://pjreddie.com/media/files/yolov3.weights"
+expected_size = 248007048
+
+
+@solara.component
+def DownloadFile(file_path=file_path, url=url, expected_size=expected_size, on_done=None):
+    download = solara.hooks.use_download(file_path, url, expected_size=expected_size)
+    downloaded_size = download.progress * expected_size
+    if on_done:
+        on_done(download.progress == 1)
+    if download.value:
+        status = "Done 🎉"
+    else:
+        MEGABYTES = 2.0**20.0
+        status = f"Downloading {file_path}... ({downloaded_size / MEGABYTES:6.2f}/{expected_size / MEGABYTES:6.2f} MB)"
+    # status = "hi"
+    # return MarkdownIt(f'{status}')
+    assert download.progress is not None
+    with rv.Container() as main:
+        # with w.VBox() as main:
+        with rv.Row():
+            with rv.Col(cols=1):
+                progressbar = rv.ProgressLinear(value=download.progress * 100, color="primary", striped=True, height=20)
+            # with rv.Col(cols=1):
+            #     MarkdownIt(f'{status}')
+    return main
+
+
+@solara.component
+def DocUseDownload():
+    with rv.Container() as main:
+        with rw.VBox(layout={"padding": "20px", "max_width": "1024px"}):
+            solara.MarkdownIt(
+                """
+# use_download
+
+```python
+def use_state(initial: T, key: str = None) -> Tuple[T, Callable[[T], T]]:
+    ...
+```
+
+use_state can be used to create a variable that is local to this component, and will be preserved during rerenders.
+
+It returns a tuple with the current value, and a setter function that should be called to change the variable. A call to this setter
+will trigger a rerender, and will cause the `use_state` function to return the new value on the next render.
+
+## Simple examples
+
+### Click button
+
+Lets start with a Button, that renders how many times it is clicked.
+        """
+            )
+            IncludeComponent(
+                DownloadFile,
+                """
+import reacton
+import solara.ipywidgets as w
+
+""",
+                highlight=[6],
+            )
+    #             MarkdownIt("""
+    # ### Markdown editor
+    # Lets continue with a more typical pattern, and create new new markdown component
+    #         """)
+    #             IncludeComponent(MarkdownIt, md_text="# This is a custom\nMark-*down* **component**")
+
+    #             MarkdownIt("""This component does not have state itself, the markdown text can only be set via its argument.
+    # A common pattern is then to have its parent component manage the state, and pass it down:
+    # """)
+    #             # IncludeComponent(MarkdownEditor, md="# Edit me\nand the markdown component **will** *update*", highlight=[3,5,6])
+    #             MarkdownIt("""Here we see the `MarkdownEditor` component using the `use_state` function to store the markdown text, while letting the `Textarea` component change its value""")
+    return main
+
+
+DownloadFile("yolov3.weights", "https://pjreddie.com/media/files/yolov3.weights", expected_size=248007048)

solara/website/pages/documentation/__init__.py

@@ -0,0 +1,90 @@
+from pathlib import Path
+
+import solara
+from solara.website.components.sidebar import Sidebar
+
+_title = "Documentation"
+
+HERE = Path(__file__).parent
+Sidebar = Sidebar
+
+route_order = ["/", "getting_started", "examples", "components", "api", "advanced", "faq"]
+
+
+@solara.component_vue(str(HERE.parent.parent / "components" / "algolia_api.vue"))
+def Algolia():
+    pass
+
+
+@solara.component
+def Page():
+    # show a gallery of all the api pages
+    router = solara.use_router()
+    route_current = router.path_routes[-2]
+    if route_current.path == "documentation":
+        with solara.Column(style={"width": "100%", "max-width": "1024px"}, gap="40px"):
+            with solara.Column(style={"width": "100%", "align-items": "center"}, gap="40px"):
+                with solara.Column(gap="20px", classes=["docs-card-container"], style={"max-width": "80%", "padding-top": "64px"}, align="stretch"):
+                    for route in route_current.children:
+                        if route.path in ["/", "advanced", "faq"]:
+                            continue
+                        with solara.Link("/documentation/" + route.path):
+                            with solara.Row(
+                                classes=["docs-card"],
+                                style={
+                                    "background-color": f"var({'--docs-color-grey' if route.path != 'getting_started' else '--color-primary'})",
+                                    "align-items": "center",
+                                },
+                            ):
+                                solara.HTML(tag="h2", unsafe_innerHTML=route.label, style={"color": "white", "display": "block", "flex-grow": "1"})
+                                solara.v.Icon(children=["mdi-arrow-right"], color="var(--color-grey-light)", x_large=True, class_="docs-card-icon")
+                with solara.Column(gap="10px", style={"flex-wrap": "wrap", "max-width": "80%"}):
+                    solara.HTML(tag="h2", unsafe_innerHTML="How to use our documentation:", style={"padding": "1.5rem"})
+                    solara.Markdown(
+                        """
+* [Getting Started](/documentation/getting_started) - Learn how to install Solara and get started with building your app.
+    Also includes tutorials for you to get a hang of Solara workflow.
+* [Examples](/documentation/examples) - More complex and real world applicable examples of Solara apps.
+    For even more complexity you can see the [Showcase](/showcase) page.
+* [Components](/documentation/components) - All the components that are available in Solara.
+* [API](/documentation/api) - All the API functions that are available in Solara. Importantly, this includes routing and hooks.
+* [Advanced](/documentation/advanced) - Advanced topics like associated and underlying libraries.
+    If a component you would like to use is not available in Solara, you can use the underlying library directly.
+                    """
+                    )
+                    solara.HTML(tag="h2", unsafe_innerHTML="Also Check Out", style={"padding": "1.5rem"})
+                    with solara.Row(gap="20px", style={"flex-wrap": "wrap", "row-gap": "20px", "align-items": "center", "padding-left": "24px"}):
+                        with solara.v.Html(tag="a", attributes={"href": "https://discord.solara.dev", "target": "_blank"}):
+                            with solara.Div(classes=["social-logo-container"], style={"background-color": "var(--docs-social-discord)"}):
+                                solara.v.Html(tag="img", attributes={"src": "/static/public/social/discord.svg"}, style_="height: 1.5rem; width: auto;")
+                        solara.Text("We use discord to provide support and answer questions there actively.")
+                    with solara.Row(gap="20px", style={"flex-wrap": "wrap", "row-gap": "20px", "align-items": "center", "padding-left": "24px"}):
+                        with solara.v.Html(tag="a", attributes={"href": "https://github.com/widgetti/solara", "target": "_blank"}):
+                            with solara.Div(classes=["social-logo-container"], style={"background-color": "var(--docs-social-github)"}):
+                                solara.v.Html(tag="img", attributes={"src": "/static/public/social/github.svg"}, style_="height: 1.5rem; width: auto;")
+                        solara.Text("Search for solutions on Github issues, or report bugs.")
+                    with solara.Row(gap="20px", style={"flex-wrap": "wrap", "row-gap": "20px", "align-items": "center", "padding-left": "24px"}):
+                        with solara.v.Html(tag="a", attributes={"href": "https://twitter.com/solara_dev", "target": "_blank"}):
+                            with solara.Div(classes=["social-logo-container"], style={"background-color": "var(--docs-social-twitter)"}):
+                                solara.v.Html(tag="img", attributes={"src": "/static/public/social/twitter.svg"}, style_="height: 1.5rem; width: auto;")
+                        solara.Text("Get announcements about Solara features, showcases, and events!.")
+
+
+@solara.component
+def Layout(children=[]):
+    route_current, all_routes = solara.use_route()
+    if route_current is None:
+        return solara.Error("Page not found")
+
+    if route_current.path == "/":
+        return Page()
+    else:
+        with solara.Column(
+            align="center", children=children, style={"padding": "0 0 40px 0", "max-width": "90%"}
+        ):  # 40px bottom margin for "runs on Solara" text
+            pass
+
+
+@solara.component
+def Overview():
+    pass

solara/website/pages/documentation/advanced/__init__.py

@@ -0,0 +1,9 @@
+from pathlib import Path
+
+from solara.autorouting import generate_routes_directory
+from solara.website.components.markdown import MarkdownWithMetadata
+
+HERE = Path(__file__)
+# if we didn't put the content in the subdirectory, but pointed to the current file
+# we would include the current file recursively, causing an infinite loop
+routes = generate_routes_directory(HERE.parent / "content", MarkdownWithMetadata)

solara/website/pages/documentation/advanced/content/00-overview.md

@@ -0,0 +1 @@
+The entries are meant as deeper dives into specific topics. Although we try to write each as a standalone document, some parts may build on previous ones.

solara/website/pages/documentation/advanced/content/10-howto/00-overview.md

@@ -0,0 +1,6 @@
+---
+title: Overview of how-to articles
+description: The how-tos are meant as deeper dives into specific topics from various perspectives
+---
+
+The how-tos are meant as deeper dives into specific topics. Although we try to write each how-to as a standalone document, some parts of a how-to may build on top of a previous one.