@akashjs/runtime 0.2.6 → 0.2.8

package/dist/pipes.d.cts

@@ -0,0 +1,130 @@
+/**
+ * Pipes — template transform functions.
+ *
+ * Pure functions that transform display values. Chainable, memoized,
+ * and usable both in templates and in script.
+ *
+ * ```ts
+ * import { pipe, uppercase, date, currency } from '@akashjs/runtime';
+ *
+ * pipe('hello', uppercase);                    // 'HELLO'
+ * pipe(new Date(), date, 'short');             // '3/29/26'
+ * pipe(1234.5, currency, 'USD');               // '$1,234.50'
+ * pipe('hello world', capitalize, truncate, 5); // 'Hello...'
+ * ```
+ */
+type PipeFn<TIn = any, TOut = any> = (value: TIn, ...args: any[]) => TOut;
+/**
+ * Apply a pipe transform to a value.
+ *
+ * ```ts
+ * pipe('hello', uppercase); // 'HELLO'
+ * pipe(1234, currency, 'USD'); // '$1,234.00'
+ * ```
+ */
+declare function pipe(value: any, transform: Function, ...rest: any[]): any;
+/**
+ * Chain multiple pipes together.
+ *
+ * ```ts
+ * const format = chain(trim, capitalize, truncate);
+ * format('  hello world  ', 10); // 'Hello w...'
+ * ```
+ */
+declare function chain<T>(...pipes: PipeFn[]): PipeFn<T, any>;
+/**
+ * Define a custom pipe.
+ *
+ * ```ts
+ * const reverse = definePipe<string, string>((value) =>
+ *   value.split('').reverse().join('')
+ * );
+ * pipe('hello', reverse); // 'olleh'
+ * ```
+ */
+declare function definePipe<TIn, TOut>(fn: PipeFn<TIn, TOut>): PipeFn<TIn, TOut>;
+/** Convert string to uppercase */
+declare const uppercase: PipeFn<string, string>;
+/** Convert string to lowercase */
+declare const lowercase: PipeFn<string, string>;
+/** Capitalize first letter */
+declare const capitalize: PipeFn<string, string>;
+/** Title case — capitalize each word */
+declare const titleCase: PipeFn<string, string>;
+/** Trim whitespace */
+declare const trim: PipeFn<string, string>;
+/**
+ * Truncate string to a max length, adding ellipsis.
+ *
+ * ```ts
+ * pipe('Hello World', truncate, 8); // 'Hello...'
+ * ```
+ */
+declare const truncate: PipeFn<string, string>;
+/**
+ * Format a date.
+ *
+ * ```ts
+ * pipe(new Date(), date);             // '3/29/2026'
+ * pipe(new Date(), date, 'short');    // '3/29/26'
+ * pipe(new Date(), date, 'long');     // 'March 29, 2026'
+ * pipe(new Date(), date, 'time');     // '2:30 PM'
+ * pipe(new Date(), date, 'iso');      // '2026-03-29T...'
+ * ```
+ */
+declare const date: PipeFn<Date | string | number, string>;
+/**
+ * Format a number as currency.
+ *
+ * ```ts
+ * pipe(1234.5, currency);         // '$1,234.50'
+ * pipe(1234.5, currency, 'EUR');  // '€1,234.50'
+ * ```
+ */
+declare const currency: PipeFn<number, string>;
+/**
+ * Format a number with locale formatting.
+ *
+ * ```ts
+ * pipe(1234567.89, number);           // '1,234,567.89'
+ * pipe(1234567.89, number, '0-2');    // '1,234,567.89' (0-2 decimal digits)
+ * ```
+ */
+declare const number: PipeFn<number, string>;
+/**
+ * Format a number as a percentage.
+ *
+ * ```ts
+ * pipe(0.85, percent);   // '85%'
+ * pipe(0.856, percent);  // '86%'
+ * ```
+ */
+declare const percent: PipeFn<number, string>;
+/**
+ * JSON stringify with formatting.
+ *
+ * ```ts
+ * pipe({ a: 1 }, json);     // '{\n  "a": 1\n}'
+ * pipe({ a: 1 }, json, 0);  // '{"a":1}'
+ * ```
+ */
+declare const json: PipeFn<unknown, string>;
+/**
+ * Pluralize a string based on count.
+ *
+ * ```ts
+ * pipe(1, plural, 'item', 'items');  // '1 item'
+ * pipe(5, plural, 'item', 'items');  // '5 items'
+ * ```
+ */
+declare const plural: PipeFn<number, string>;
+/**
+ * Relative time formatting.
+ *
+ * ```ts
+ * pipe(Date.now() - 60000, relativeTime);  // '1 minute ago'
+ * ```
+ */
+declare const relativeTime: PipeFn<Date | number, string>;
+
+export { type PipeFn, capitalize, chain, currency, date, definePipe, json, lowercase, number, percent, pipe, plural, relativeTime, titleCase, trim, truncate, uppercase };

package/dist/pipes.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Pipes — template transform functions.
+ *
+ * Pure functions that transform display values. Chainable, memoized,
+ * and usable both in templates and in script.
+ *
+ * ```ts
+ * import { pipe, uppercase, date, currency } from '@akashjs/runtime';
+ *
+ * pipe('hello', uppercase);                    // 'HELLO'
+ * pipe(new Date(), date, 'short');             // '3/29/26'
+ * pipe(1234.5, currency, 'USD');               // '$1,234.50'
+ * pipe('hello world', capitalize, truncate, 5); // 'Hello...'
+ * ```
+ */
+type PipeFn<TIn = any, TOut = any> = (value: TIn, ...args: any[]) => TOut;
+/**
+ * Apply a pipe transform to a value.
+ *
+ * ```ts
+ * pipe('hello', uppercase); // 'HELLO'
+ * pipe(1234, currency, 'USD'); // '$1,234.00'
+ * ```
+ */
+declare function pipe(value: any, transform: Function, ...rest: any[]): any;
+/**
+ * Chain multiple pipes together.
+ *
+ * ```ts
+ * const format = chain(trim, capitalize, truncate);
+ * format('  hello world  ', 10); // 'Hello w...'
+ * ```
+ */
+declare function chain<T>(...pipes: PipeFn[]): PipeFn<T, any>;
+/**
+ * Define a custom pipe.
+ *
+ * ```ts
+ * const reverse = definePipe<string, string>((value) =>
+ *   value.split('').reverse().join('')
+ * );
+ * pipe('hello', reverse); // 'olleh'
+ * ```
+ */
+declare function definePipe<TIn, TOut>(fn: PipeFn<TIn, TOut>): PipeFn<TIn, TOut>;
+/** Convert string to uppercase */
+declare const uppercase: PipeFn<string, string>;
+/** Convert string to lowercase */
+declare const lowercase: PipeFn<string, string>;
+/** Capitalize first letter */
+declare const capitalize: PipeFn<string, string>;
+/** Title case — capitalize each word */
+declare const titleCase: PipeFn<string, string>;
+/** Trim whitespace */
+declare const trim: PipeFn<string, string>;
+/**
+ * Truncate string to a max length, adding ellipsis.
+ *
+ * ```ts
+ * pipe('Hello World', truncate, 8); // 'Hello...'
+ * ```
+ */
+declare const truncate: PipeFn<string, string>;
+/**
+ * Format a date.
+ *
+ * ```ts
+ * pipe(new Date(), date);             // '3/29/2026'
+ * pipe(new Date(), date, 'short');    // '3/29/26'
+ * pipe(new Date(), date, 'long');     // 'March 29, 2026'
+ * pipe(new Date(), date, 'time');     // '2:30 PM'
+ * pipe(new Date(), date, 'iso');      // '2026-03-29T...'
+ * ```
+ */
+declare const date: PipeFn<Date | string | number, string>;
+/**
+ * Format a number as currency.
+ *
+ * ```ts
+ * pipe(1234.5, currency);         // '$1,234.50'
+ * pipe(1234.5, currency, 'EUR');  // '€1,234.50'
+ * ```
+ */
+declare const currency: PipeFn<number, string>;
+/**
+ * Format a number with locale formatting.
+ *
+ * ```ts
+ * pipe(1234567.89, number);           // '1,234,567.89'
+ * pipe(1234567.89, number, '0-2');    // '1,234,567.89' (0-2 decimal digits)
+ * ```
+ */
+declare const number: PipeFn<number, string>;
+/**
+ * Format a number as a percentage.
+ *
+ * ```ts
+ * pipe(0.85, percent);   // '85%'
+ * pipe(0.856, percent);  // '86%'
+ * ```
+ */
+declare const percent: PipeFn<number, string>;
+/**
+ * JSON stringify with formatting.
+ *
+ * ```ts
+ * pipe({ a: 1 }, json);     // '{\n  "a": 1\n}'
+ * pipe({ a: 1 }, json, 0);  // '{"a":1}'
+ * ```
+ */
+declare const json: PipeFn<unknown, string>;
+/**
+ * Pluralize a string based on count.
+ *
+ * ```ts
+ * pipe(1, plural, 'item', 'items');  // '1 item'
+ * pipe(5, plural, 'item', 'items');  // '5 items'
+ * ```
+ */
+declare const plural: PipeFn<number, string>;
+/**
+ * Relative time formatting.
+ *
+ * ```ts
+ * pipe(Date.now() - 60000, relativeTime);  // '1 minute ago'
+ * ```
+ */
+declare const relativeTime: PipeFn<Date | number, string>;
+
+export { type PipeFn, capitalize, chain, currency, date, definePipe, json, lowercase, number, percent, pipe, plural, relativeTime, titleCase, trim, truncate, uppercase };

package/dist/pipes.js

@@ -0,0 +1,2 @@
+export{f as capitalize,b as chain,k as currency,j as date,c as definePipe,n as json,e as lowercase,l as number,m as percent,a as pipe,o as plural,p as relativeTime,g as titleCase,h as trim,i as truncate,d as uppercase}from'./chunk-AXB5GHGO.js';//# sourceMappingURL=pipes.js.map
+//# sourceMappingURL=pipes.js.map

package/dist/pipes.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"pipes.js"}

package/dist/plugin.cjs

@@ -0,0 +1,2 @@
+'use strict';var chunk45DPEU7T_cjs=require('./chunk-45DPEU7T.cjs');require('./chunk-IQGSDFBI.cjs'),require('./chunk-PPNEAFKE.cjs');Object.defineProperty(exports,"createApp",{enumerable:true,get:function(){return chunk45DPEU7T_cjs.b}});Object.defineProperty(exports,"definePlugin",{enumerable:true,get:function(){return chunk45DPEU7T_cjs.a}});//# sourceMappingURL=plugin.cjs.map
+//# sourceMappingURL=plugin.cjs.map

package/dist/plugin.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"plugin.cjs"}

package/dist/plugin.d.cts

@@ -0,0 +1,70 @@
+import { I as InjectionKey } from './context-Cwt7QCpk.cjs';
+import { C as Component } from './component-CxlupKuc.cjs';
+import './types-DjZCk1xT.cjs';
+
+/**
+ * Plugin system.
+ *
+ * Allows third-party extensions to hook into the AkashJS lifecycle.
+ * Plugins can provide context values, add global error handlers,
+ * register stores, and run setup code.
+ *
+ * ```ts
+ * const authPlugin = definePlugin({
+ *   name: 'auth',
+ *   setup(app) {
+ *     const store = defineStore('auth', { ... })();
+ *     app.provide(AuthContext, store);
+ *     app.onError((err) => { if (err.status === 401) logout(); });
+ *   },
+ * });
+ *
+ * const app = createApp(App);
+ * app.use(authPlugin);
+ * app.mount('#app');
+ * ```
+ */
+
+interface PluginContext {
+    /** Provide a value to all components */
+    provide<T>(key: InjectionKey<T>, value: T): void;
+    /** Register a global error handler */
+    onError(handler: (error: Error) => void): void;
+    /** Register a hook that runs before each component mount */
+    onBeforeMount(hook: () => void): void;
+    /** Access the app config */
+    config: Record<string, unknown>;
+}
+interface Plugin {
+    /** Plugin name (for debugging) */
+    name: string;
+    /** Setup function called when the plugin is installed */
+    setup: (ctx: PluginContext) => void | Promise<void>;
+}
+interface AppInstance {
+    /** Install a plugin */
+    use(plugin: Plugin): AppInstance;
+    /** Set a config value */
+    config(key: string, value: unknown): AppInstance;
+    /** Mount the app to a DOM element */
+    mount(selector: string | HTMLElement): void;
+    /** Unmount the app */
+    unmount(): void;
+}
+/**
+ * Define a framework plugin.
+ */
+declare function definePlugin(plugin: Plugin): Plugin;
+/**
+ * Create an application instance with plugin support.
+ *
+ * ```ts
+ * const app = createApp(App);
+ * app.use(authPlugin);
+ * app.use(i18nPlugin);
+ * app.mount('#app');
+ * ```
+ */
+declare function createApp<P extends Record<string, unknown>>(rootComponent: Component<P>, rootProps?: P): AppInstance;
+
+export { type AppInstance, type Plugin, type PluginContext, createApp, definePlugin };

package/dist/plugin.d.ts

@@ -0,0 +1,70 @@
+import { I as InjectionKey } from './context-Cwt7QCpk.js';
+import { C as Component } from './component-CPVtkASo.js';
+import './types-DjZCk1xT.js';
+
+/**
+ * Plugin system.
+ *
+ * Allows third-party extensions to hook into the AkashJS lifecycle.
+ * Plugins can provide context values, add global error handlers,
+ * register stores, and run setup code.
+ *
+ * ```ts
+ * const authPlugin = definePlugin({
+ *   name: 'auth',
+ *   setup(app) {
+ *     const store = defineStore('auth', { ... })();
+ *     app.provide(AuthContext, store);
+ *     app.onError((err) => { if (err.status === 401) logout(); });
+ *   },
+ * });
+ *
+ * const app = createApp(App);
+ * app.use(authPlugin);
+ * app.mount('#app');
+ * ```
+ */
+
+interface PluginContext {
+    /** Provide a value to all components */
+    provide<T>(key: InjectionKey<T>, value: T): void;
+    /** Register a global error handler */
+    onError(handler: (error: Error) => void): void;
+    /** Register a hook that runs before each component mount */
+    onBeforeMount(hook: () => void): void;
+    /** Access the app config */
+    config: Record<string, unknown>;
+}
+interface Plugin {
+    /** Plugin name (for debugging) */
+    name: string;
+    /** Setup function called when the plugin is installed */
+    setup: (ctx: PluginContext) => void | Promise<void>;
+}
+interface AppInstance {
+    /** Install a plugin */
+    use(plugin: Plugin): AppInstance;
+    /** Set a config value */
+    config(key: string, value: unknown): AppInstance;
+    /** Mount the app to a DOM element */
+    mount(selector: string | HTMLElement): void;
+    /** Unmount the app */
+    unmount(): void;
+}
+/**
+ * Define a framework plugin.
+ */
+declare function definePlugin(plugin: Plugin): Plugin;
+/**
+ * Create an application instance with plugin support.
+ *
+ * ```ts
+ * const app = createApp(App);
+ * app.use(authPlugin);
+ * app.use(i18nPlugin);
+ * app.mount('#app');
+ * ```
+ */
+declare function createApp<P extends Record<string, unknown>>(rootComponent: Component<P>, rootProps?: P): AppInstance;
+
+export { type AppInstance, type Plugin, type PluginContext, createApp, definePlugin };

package/dist/plugin.js

@@ -0,0 +1,2 @@
+export{b as createApp,a as definePlugin}from'./chunk-IHEW6F2H.js';import'./chunk-VUMMC2P5.js';import'./chunk-AOFLE33X.js';//# sourceMappingURL=plugin.js.map
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"plugin.js"}

package/dist/portal.cjs

@@ -0,0 +1,2 @@
+'use strict';var chunkE7GAIKQT_cjs=require('./chunk-E7GAIKQT.cjs');require('./chunk-LSD7DEMV.cjs'),require('./chunk-IQGSDFBI.cjs'),require('./chunk-PPNEAFKE.cjs'),require('./chunk-HL2VGVJT.cjs'),require('./chunk-XPLIEN2G.cjs');Object.defineProperty(exports,"Portal",{enumerable:true,get:function(){return chunkE7GAIKQT_cjs.a}});//# sourceMappingURL=portal.cjs.map
+//# sourceMappingURL=portal.cjs.map

package/dist/portal.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"portal.cjs"}

package/dist/portal.d.cts

@@ -0,0 +1,30 @@
+import { C as Component } from './component-CxlupKuc.cjs';
+import './types-DjZCk1xT.cjs';
+
+/**
+ * <Portal> component.
+ *
+ * Renders children into a different DOM node, outside the
+ * component tree. Essential for modals, tooltips, toasts,
+ * dropdowns, and overlays.
+ *
+ * ```html
+ * <Portal target="body">
+ *   <div class="modal">Modal content</div>
+ * </Portal>
+ *
+ * <Portal target="#tooltip-container">
+ *   <Tooltip />
+ * </Portal>
+ * ```
+ */
+interface PortalProps {
+    /** CSS selector or HTMLElement to render into (default: document.body) */
+    target?: string | HTMLElement;
+}
+/**
+ * <Portal> — render children into a different DOM location.
+ */
+declare const Portal: Component<PortalProps>;
+
+export { Portal, type PortalProps };

package/dist/portal.d.ts

@@ -0,0 +1,30 @@
+import { C as Component } from './component-CPVtkASo.js';
+import './types-DjZCk1xT.js';
+
+/**
+ * <Portal> component.
+ *
+ * Renders children into a different DOM node, outside the
+ * component tree. Essential for modals, tooltips, toasts,
+ * dropdowns, and overlays.
+ *
+ * ```html
+ * <Portal target="body">
+ *   <div class="modal">Modal content</div>
+ * </Portal>
+ *
+ * <Portal target="#tooltip-container">
+ *   <Tooltip />
+ * </Portal>
+ * ```
+ */
+interface PortalProps {
+    /** CSS selector or HTMLElement to render into (default: document.body) */
+    target?: string | HTMLElement;
+}
+/**
+ * <Portal> — render children into a different DOM location.
+ */
+declare const Portal: Component<PortalProps>;
+
+export { Portal, type PortalProps };

package/dist/portal.js

@@ -0,0 +1,2 @@
+export{a as Portal}from'./chunk-XAGYLTHV.js';import'./chunk-CDZR6GWB.js';import'./chunk-VUMMC2P5.js';import'./chunk-AOFLE33X.js';import'./chunk-2UATNCKC.js';import'./chunk-U65WRXZC.js';//# sourceMappingURL=portal.js.map
+//# sourceMappingURL=portal.js.map

package/dist/portal.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"portal.js"}

package/dist/pwa.cjs

@@ -1,2 +1,2 @@
-'use strict';var chunkZYVQQ5VR_cjs=require('./chunk-ZYVQQ5VR.cjs');require('./chunk-EEILP4OL.cjs');Object.defineProperty(exports,"generateSWScript",{enumerable:true,get:function(){return chunkZYVQQ5VR_cjs.b}});Object.defineProperty(exports,"registerServiceWorker",{enumerable:true,get:function(){return chunkZYVQQ5VR_cjs.a}});Object.defineProperty(exports,"subscribePush",{enumerable:true,get:function(){return chunkZYVQQ5VR_cjs.c}});//# sourceMappingURL=pwa.cjs.map
+'use strict';var chunkF2F5OXCK_cjs=require('./chunk-F2F5OXCK.cjs');require('./chunk-HL2VGVJT.cjs'),require('./chunk-XPLIEN2G.cjs');Object.defineProperty(exports,"generateSWScript",{enumerable:true,get:function(){return chunkF2F5OXCK_cjs.b}});Object.defineProperty(exports,"registerServiceWorker",{enumerable:true,get:function(){return chunkF2F5OXCK_cjs.a}});Object.defineProperty(exports,"subscribePush",{enumerable:true,get:function(){return chunkF2F5OXCK_cjs.c}});//# sourceMappingURL=pwa.cjs.map
 //# sourceMappingURL=pwa.cjs.map

package/dist/pwa.d.cts

@@ -1,4 +1,4 @@
-import { R as ReadonlySignal } from './signals-C7XfOHHR.cjs';
+import { R as ReadonlySignal } from './signals-DionyGGY.cjs';
 
 /**
  * PWA / Service Worker support.

package/dist/pwa.d.ts

@@ -1,4 +1,4 @@
-import { R as ReadonlySignal } from './signals-C7XfOHHR.js';
+import { R as ReadonlySignal } from './signals-DionyGGY.js';
 
 /**
  * PWA / Service Worker support.

package/dist/pwa.js

@@ -1,2 +1,2 @@
-export{b as generateSWScript,a as registerServiceWorker,c as subscribePush}from'./chunk-U53YRJNV.js';import'./chunk-3GRR4VW2.js';//# sourceMappingURL=pwa.js.map
+export{b as generateSWScript,a as registerServiceWorker,c as subscribePush}from'./chunk-GRXHWCFR.js';import'./chunk-2UATNCKC.js';import'./chunk-U65WRXZC.js';//# sourceMappingURL=pwa.js.map
 //# sourceMappingURL=pwa.js.map

package/dist/query-state.cjs

@@ -0,0 +1,2 @@
+'use strict';var chunkBLT7XOSX_cjs=require('./chunk-BLT7XOSX.cjs');require('./chunk-HL2VGVJT.cjs'),require('./chunk-XPLIEN2G.cjs');Object.defineProperty(exports,"clearQueryState",{enumerable:true,get:function(){return chunkBLT7XOSX_cjs.c}});Object.defineProperty(exports,"getQueryParams",{enumerable:true,get:function(){return chunkBLT7XOSX_cjs.d}});Object.defineProperty(exports,"removeQueryState",{enumerable:true,get:function(){return chunkBLT7XOSX_cjs.e}});Object.defineProperty(exports,"resetQueryState",{enumerable:true,get:function(){return chunkBLT7XOSX_cjs.f}});Object.defineProperty(exports,"useQueryState",{enumerable:true,get:function(){return chunkBLT7XOSX_cjs.a}});Object.defineProperty(exports,"useQueryStates",{enumerable:true,get:function(){return chunkBLT7XOSX_cjs.b}});//# sourceMappingURL=query-state.cjs.map
+//# sourceMappingURL=query-state.cjs.map

package/dist/query-state.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"query-state.cjs"}

package/dist/query-state.d.cts

@@ -0,0 +1,82 @@
+import { S as Signal } from './signals-DionyGGY.cjs';
+
+/**
+ * URL-synced reactive state.
+ *
+ * Automatically sync signal values to URL query parameters.
+ * Users can share links, use browser back/forward, and state
+ * persists across page reloads — all with zero boilerplate.
+ *
+ * ```ts
+ * const search = useQueryState('q', '');
+ * const page = useQueryState('page', 1);
+ * const tags = useQueryState('tags', ['js']);
+ *
+ * search.set('akashjs'); // URL → ?q=akashjs&page=1&tags=js
+ * // User hits back → signals update automatically
+ * ```
+ */
+
+interface QueryStateOptions<T> {
+    /** Custom serializer (default: auto-detect from type) */
+    serialize?: (value: T) => string;
+    /** Custom deserializer (default: auto-detect from type) */
+    deserialize?: (raw: string) => T;
+    /** Whether to push or replace history entry (default: 'replace') */
+    history?: 'push' | 'replace';
+    /** Debounce URL updates in ms (default: 0) */
+    debounce?: number;
+    /** Remove param from URL when value equals default */
+    removeDefault?: boolean;
+}
+/**
+ * Create a signal synced to a URL query parameter.
+ *
+ * ```ts
+ * const search = useQueryState('q', '');
+ * search();            // reads from URL or default
+ * search.set('hello'); // updates URL to ?q=hello
+ * ```
+ */
+declare function useQueryState<T>(key: string, defaultValue: T, options?: QueryStateOptions<T>): Signal<T>;
+type QueryStateSchema = Record<string, {
+    default: unknown;
+    serialize?: (value: any) => string;
+    deserialize?: (raw: string) => any;
+}>;
+type QueryStates<T extends QueryStateSchema> = {
+    [K in keyof T]: Signal<T[K]['default']>;
+};
+/**
+ * Create multiple URL-synced signals at once.
+ * All updates within a batch result in a single URL change.
+ *
+ * ```ts
+ * const { q, page, sort } = useQueryStates({
+ *   q: { default: '' },
+ *   page: { default: 1 },
+ *   sort: { default: 'name' },
+ * });
+ * ```
+ */
+declare function useQueryStates<T extends QueryStateSchema>(schema: T, options?: {
+    history?: 'push' | 'replace';
+}): QueryStates<T>;
+/**
+ * Remove all query state params from the URL.
+ */
+declare function clearQueryState(): void;
+/**
+ * Get all current query params as a plain object.
+ */
+declare function getQueryParams(): Record<string, string>;
+/**
+ * Cleanup: remove a specific query state binding.
+ */
+declare function removeQueryState(key: string): void;
+/**
+ * Cleanup all query state bindings (useful for testing).
+ */
+declare function resetQueryState(): void;
+
+export { type QueryStateOptions, clearQueryState, getQueryParams, removeQueryState, resetQueryState, useQueryState, useQueryStates };