chore(release): 6.5.0 [skip ci]

# [6.5.0](v6.4.1...v6.5.0) (2026-09-04)

### Features

* astro hook ([555159c](555159c))

Author: semantic-release-bot

CHANGELOG.md

@@ -1,3 +1,10 @@
+# [6.5.0](https://github.com/asmyshlyaev177/state-in-url/compare/v6.4.1...v6.5.0) (2026-09-04)
+
+
+### Features
+
+* astro hook ([555159c](https://github.com/asmyshlyaev177/state-in-url/commit/555159c8743b700cdbd2525fa8f48681cf1cd7ef))
+
 ## [6.4.1](https://github.com/asmyshlyaev177/state-in-url/compare/v6.4.0...v6.4.1) (2026-08-21)
 
 

dist/astro/index.d.ts

@@ -0,0 +1 @@
+export { useUrlState } from './useUrlState';

dist/astro/index.js

@@ -0,0 +1 @@
+"use strict";var e=require("./useUrlState/useUrlState.js");exports.useUrlState=e.useUrlState;

dist/astro/index.mjs

@@ -0,0 +1 @@
+import{useUrlState as t}from"./useUrlState/useUrlState.mjs";export{t as useUrlState};

dist/astro/useUrlState/index.d.ts

@@ -0,0 +1 @@
+export * from './useUrlState';

dist/astro/useUrlState/index.js

@@ -0,0 +1 @@
+"use strict";var e=require("./useUrlState.js");exports.useUrlState=e.useUrlState;

dist/astro/useUrlState/index.mjs

@@ -0,0 +1 @@
+import{useUrlState as t}from"./useUrlState.mjs";export{t as useUrlState};

dist/astro/useUrlState/useUrlState.d.ts

@@ -0,0 +1,85 @@
+import { type JSONCompatible } from '../../utils';
+/**
+ * Astro hook, for React islands. Returns `urlState`, `setState`, and `setUrl` functions
+ *
+ * Astro has no client-side router by default, so the URL is written with
+ * `window.history` and read back on back/forward, on this hook's own writes,
+ * and on any other `pushState`/`replaceState`, `<ClientRouter />` included.
+ * Islands on one page share the state.
+ *
+ * @param {JSONCompatible<T>} [defaultState] Fallback (default) values for state
+ * @param {Object} params - Object with other parameters
+ * @param {boolean} params.replace replace URL or push, default `true`
+ * @param {?object} params.searchParams `Object.fromEntries(Astro.url.searchParams)`, passed as an island prop so the server render matches the URL
+ * @returns {Object} [result] State and callbacks
+ * @returns {Object} [result.urlState] - current state object
+ * @returns {Function} [result.setUrl] - function to update state and url
+ * @returns {Function} [result.setState] - function to update state only
+ * @returns {Function} [result.reset] - function to reset state and url to default
+ *
+ * * Example:
+ * ```ts
+ * export const form = { name: '', age: 0 };
+ * // island: <Form client:load searchParams={Object.fromEntries(Astro.url.searchParams)} />
+ * const { urlState, setState, setUrl, reset } = useUrlState(form, { searchParams });
+ *
+ * setState({ name: 'test' });
+ * setUrl({ name: 'test' }, { replace: false });
+ * setUrl(curr => ({ ...curr, name: 'test' }));
+ * // RESET state and url
+ * setUrl((_curr, initialState) => initialState);
+ * // Or
+ * reset();
+ * reset({ replace: false });
+ *  ```
+ *
+ *  * Docs {@link https://github.com/asmyshlyaev177/state-in-url/tree/master/packages/urlstate/astro/useUrlState}
+ */
+export declare function useUrlState<T extends JSONCompatible>(defaultState: T, params?: Params): {
+    /**
+     * State object. Don't mutate directly, use `setState` or `setUrl`
+     */
+    urlState: T;
+    /**
+     * * Example:
+     * ```ts
+     * setState({ name: 'test' });
+     * // or
+     * setState(curr => ({ ...curr, name: 'test' }) );
+     *  ```
+     *
+     *  * Docs {@link https://github.com/asmyshlyaev177/state-in-url/tree/master/packages/urlstate/astro/useUrlState#setstate}
+     */
+    setState: (value: Partial<T> | ((currState: T, initial: T) => T)) => void;
+    /**
+     * * Example:
+     * ```ts
+     * setUrl({ name: 'test' });
+     * // or
+     * setUrl((curr) => ({ ...curr, name: 'test' }), { replace: false } );
+     *  * Reset
+     *  setUrl((_curr, initialState) => initialState, { replace: false } );
+     *  ```
+     *
+     *  * Docs {@link https://github.com/asmyshlyaev177/state-in-url/tree/master/packages/urlstate/astro/useUrlState#seturl}
+     */
+    setUrl: (value?: Partial<T> | ((currState: T, initialState: T) => T), options?: Options) => void;
+    /**
+     * * Example:
+     * ```ts
+     * reset();
+     * // or
+     * reset({ replace: false })
+     *  ```
+     *
+     *  * Docs {@link https://github.com/asmyshlyaev177/state-in-url/tree/master/packages/urlstate/astro/useUrlState#reset}
+     */
+    reset: (options?: Options) => void;
+};
+export type Options = {
+    replace?: boolean;
+};
+export type Params = {
+    searchParams?: object;
+    replace?: boolean;
+};

dist/astro/useUrlState/useUrlState.js

@@ -0,0 +1 @@
+import r from"react";import{parseSPObj as u}from"../../parseSPObj.mjs";import{useUrlStateBase as g}from"../../useUrlStateBase/useUrlStateBase.mjs";import{isSSR as k,filterUnknownParams as i,filterUnknownParamsClient as d,getSearch as m,routerHistory as C,getParams as h,subscribeToUrl as j}from"../../utils.mjs";function w(e,a){const{state:p,updateState:n,updateUrl:l,reset:c,getState:f,pendingUrlUpdate:S}=g(e,C,({parse:t})=>k?u(i(e,a?.searchParams),e):t(d(e,a?.searchParams||m())));const o=r.useCallback(()=>{if(S())return;n(i(e,u(Object.fromEntries(h(m()).entries()),e)))},[]);r.useEffect(()=>{o();return j(o)},[o]);const s=r.useMemo(()=>({replace:a?.replace??true}),[a?.replace]);const U=r.useCallback((t,P)=>l(t,{...s,...P}),[l,s]);const b=r.useCallback(t=>{c({...s,...t})},[c,s]);return{setState:n,setUrl:U,urlState:p,reset:b,getState:f}}export{w as useUrlState};