@akashjs/runtime 0.2.2 → 0.2.7

package/dist/event-bus.d.cts

@@ -0,0 +1,68 @@
+/**
+ * Event bus — typed pub/sub for cross-component communication.
+ *
+ * Fire-and-forget events between unrelated components without
+ * prop drilling or context coupling.
+ *
+ * ```ts
+ * const bus = createEventBus<{
+ *   'user:login': { userId: string };
+ *   'cart:updated': { itemCount: number };
+ *   'notification': string;
+ * }>();
+ *
+ * // Subscribe
+ * bus.on('user:login', ({ userId }) => fetchProfile(userId));
+ *
+ * // Emit from anywhere
+ * bus.emit('user:login', { userId: '123' });
+ *
+ * // One-time listener
+ * bus.once('cart:updated', ({ itemCount }) => showBadge(itemCount));
+ * ```
+ */
+type EventMap = Record<string, unknown>;
+type EventHandler<T = unknown> = (data: T) => void;
+interface EventBus<T extends EventMap> {
+    /** Subscribe to an event */
+    on<K extends keyof T & string>(event: K, handler: EventHandler<T[K]>): () => void;
+    /** Subscribe once — auto-removes after first call */
+    once<K extends keyof T & string>(event: K, handler: EventHandler<T[K]>): () => void;
+    /** Emit an event to all listeners */
+    emit<K extends keyof T & string>(event: K, data: T[K]): void;
+    /** Remove a specific handler */
+    off<K extends keyof T & string>(event: K, handler: EventHandler<T[K]>): void;
+    /** Remove all handlers for an event (or all events) */
+    clear(event?: keyof T & string): void;
+    /** Get listener count for an event */
+    listenerCount(event: keyof T & string): number;
+    /** Check if an event has listeners */
+    hasListeners(event: keyof T & string): boolean;
+}
+/**
+ * Create a typed event bus.
+ *
+ * ```ts
+ * const bus = createEventBus<{
+ *   'theme:change': 'light' | 'dark';
+ *   'toast': { message: string; type: string };
+ * }>();
+ * ```
+ */
+declare function createEventBus<T extends EventMap = Record<string, unknown>>(): EventBus<T>;
+/**
+ * Get the global event bus (created on first call).
+ *
+ * ```ts
+ * import { globalEventBus } from '@akashjs/runtime';
+ *
+ * // In component A:
+ * globalEventBus().emit('notification', 'Hello!');
+ *
+ * // In component B:
+ * globalEventBus().on('notification', (msg) => show(msg));
+ * ```
+ */
+declare function globalEventBus<T extends EventMap = Record<string, unknown>>(): EventBus<T>;
+
+export { type EventBus, type EventHandler, type EventMap, createEventBus, globalEventBus };

package/dist/event-bus.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Event bus — typed pub/sub for cross-component communication.
+ *
+ * Fire-and-forget events between unrelated components without
+ * prop drilling or context coupling.
+ *
+ * ```ts
+ * const bus = createEventBus<{
+ *   'user:login': { userId: string };
+ *   'cart:updated': { itemCount: number };
+ *   'notification': string;
+ * }>();
+ *
+ * // Subscribe
+ * bus.on('user:login', ({ userId }) => fetchProfile(userId));
+ *
+ * // Emit from anywhere
+ * bus.emit('user:login', { userId: '123' });
+ *
+ * // One-time listener
+ * bus.once('cart:updated', ({ itemCount }) => showBadge(itemCount));
+ * ```
+ */
+type EventMap = Record<string, unknown>;
+type EventHandler<T = unknown> = (data: T) => void;
+interface EventBus<T extends EventMap> {
+    /** Subscribe to an event */
+    on<K extends keyof T & string>(event: K, handler: EventHandler<T[K]>): () => void;
+    /** Subscribe once — auto-removes after first call */
+    once<K extends keyof T & string>(event: K, handler: EventHandler<T[K]>): () => void;
+    /** Emit an event to all listeners */
+    emit<K extends keyof T & string>(event: K, data: T[K]): void;
+    /** Remove a specific handler */
+    off<K extends keyof T & string>(event: K, handler: EventHandler<T[K]>): void;
+    /** Remove all handlers for an event (or all events) */
+    clear(event?: keyof T & string): void;
+    /** Get listener count for an event */
+    listenerCount(event: keyof T & string): number;
+    /** Check if an event has listeners */
+    hasListeners(event: keyof T & string): boolean;
+}
+/**
+ * Create a typed event bus.
+ *
+ * ```ts
+ * const bus = createEventBus<{
+ *   'theme:change': 'light' | 'dark';
+ *   'toast': { message: string; type: string };
+ * }>();
+ * ```
+ */
+declare function createEventBus<T extends EventMap = Record<string, unknown>>(): EventBus<T>;
+/**
+ * Get the global event bus (created on first call).
+ *
+ * ```ts
+ * import { globalEventBus } from '@akashjs/runtime';
+ *
+ * // In component A:
+ * globalEventBus().emit('notification', 'Hello!');
+ *
+ * // In component B:
+ * globalEventBus().on('notification', (msg) => show(msg));
+ * ```
+ */
+declare function globalEventBus<T extends EventMap = Record<string, unknown>>(): EventBus<T>;
+
+export { type EventBus, type EventHandler, type EventMap, createEventBus, globalEventBus };

package/dist/event-bus.js

@@ -0,0 +1,2 @@
+export{a as createEventBus,b as globalEventBus}from'./chunk-IJS2EMSE.js';//# sourceMappingURL=event-bus.js.map
+//# sourceMappingURL=event-bus.js.map

package/dist/event-bus.js.map

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

package/dist/event-modifiers.cjs

@@ -0,0 +1,2 @@
+'use strict';var chunk7UX5CSGZ_cjs=require('./chunk-7UX5CSGZ.cjs');require('./chunk-WOZWFMOK.cjs'),require('./chunk-XPLIEN2G.cjs');Object.defineProperty(exports,"bindClass",{enumerable:true,get:function(){return chunk7UX5CSGZ_cjs.h}});Object.defineProperty(exports,"bindClasses",{enumerable:true,get:function(){return chunk7UX5CSGZ_cjs.i}});Object.defineProperty(exports,"bindDimensions",{enumerable:true,get:function(){return chunk7UX5CSGZ_cjs.c}});Object.defineProperty(exports,"bindElement",{enumerable:true,get:function(){return chunk7UX5CSGZ_cjs.e}});Object.defineProperty(exports,"bindGroup",{enumerable:true,get:function(){return chunk7UX5CSGZ_cjs.f}});Object.defineProperty(exports,"bindGroupItem",{enumerable:true,get:function(){return chunk7UX5CSGZ_cjs.g}});Object.defineProperty(exports,"bindScroll",{enumerable:true,get:function(){return chunk7UX5CSGZ_cjs.d}});Object.defineProperty(exports,"bindStyle",{enumerable:true,get:function(){return chunk7UX5CSGZ_cjs.j}});Object.defineProperty(exports,"bindStyles",{enumerable:true,get:function(){return chunk7UX5CSGZ_cjs.k}});Object.defineProperty(exports,"onEvent",{enumerable:true,get:function(){return chunk7UX5CSGZ_cjs.b}});Object.defineProperty(exports,"withModifiers",{enumerable:true,get:function(){return chunk7UX5CSGZ_cjs.a}});//# sourceMappingURL=event-modifiers.cjs.map
+//# sourceMappingURL=event-modifiers.cjs.map

package/dist/event-modifiers.cjs.map

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

package/dist/event-modifiers.d.cts

@@ -0,0 +1,130 @@
+import { R as ReadonlySignal, S as Signal } from './signals-DionyGGY.cjs';
+
+/**
+ * Event modifiers and extended bind/class/style directives.
+ *
+ * Modifiers: onClick|preventDefault|stopPropagation|once|self|capture
+ * Extended binds: bind:clientWidth, bind:scrollY, bind:group, bind:this
+ * Class directive: class:active={isActive}
+ * Style directive: style:color={textColor}
+ */
+
+interface EventModifiers {
+    preventDefault?: boolean;
+    stopPropagation?: boolean;
+    stopImmediatePropagation?: boolean;
+    once?: boolean;
+    capture?: boolean;
+    passive?: boolean;
+    self?: boolean;
+}
+/**
+ * Wrap an event handler with modifiers.
+ *
+ * ```ts
+ * const handler = withModifiers(onClick, {
+ *   preventDefault: true,
+ *   stopPropagation: true,
+ *   once: true,
+ * });
+ * el.addEventListener('click', handler);
+ * ```
+ */
+declare function withModifiers<E extends Event>(handler: (e: E) => void, modifiers: EventModifiers): (e: E) => void;
+/**
+ * Attach an event handler with modifiers to an element.
+ *
+ * ```ts
+ * onEvent(el, 'click', handler, { preventDefault: true, once: true });
+ * ```
+ */
+declare function onEvent<K extends keyof HTMLElementEventMap>(el: HTMLElement, event: K, handler: (e: HTMLElementEventMap[K]) => void, modifiers?: EventModifiers): () => void;
+/**
+ * Bind element dimensions to signals (read-only, auto-updating).
+ *
+ * ```ts
+ * const { width, height } = bindDimensions(el);
+ * width(); // tracks clientWidth
+ * ```
+ */
+declare function bindDimensions(el: HTMLElement): {
+    width: ReadonlySignal<number>;
+    height: ReadonlySignal<number>;
+};
+/**
+ * Bind scroll position to signals.
+ *
+ * ```ts
+ * const { scrollX, scrollY } = bindScroll(el);
+ * // or for window:
+ * const { scrollX, scrollY } = bindScroll();
+ * ```
+ */
+declare function bindScroll(el?: HTMLElement): {
+    scrollX: Signal<number>;
+    scrollY: Signal<number>;
+};
+/**
+ * Bind a signal to an element reference (like bind:this in Svelte).
+ *
+ * ```ts
+ * const myRef = bindElement<HTMLInputElement>();
+ * // In render: myRef.set(inputEl);
+ * myRef()?.focus();
+ * ```
+ */
+declare function bindElement<T extends HTMLElement = HTMLElement>(): Signal<T | null>;
+/**
+ * Bind a group of radio/checkbox inputs to a signal.
+ *
+ * ```ts
+ * const selected = bindGroup<string>('color');
+ * // Apply to each radio: bindGroupItem(radioEl, selected, 'red');
+ * ```
+ */
+declare function bindGroup<T>(name: string): Signal<T | null>;
+declare function bindGroupItem<T>(el: HTMLInputElement, group: Signal<T | null>, value: T): void;
+/**
+ * Conditionally apply a CSS class based on a reactive condition.
+ *
+ * ```ts
+ * bindClass(el, 'active', () => isActive());
+ * bindClass(el, 'disabled', () => isDisabled());
+ * ```
+ */
+declare function bindClass(el: HTMLElement, className: string, condition: () => boolean): () => void;
+/**
+ * Apply multiple conditional classes at once.
+ *
+ * ```ts
+ * bindClasses(el, {
+ *   active: () => isActive(),
+ *   disabled: () => isDisabled(),
+ *   'text-bold': () => isBold(),
+ * });
+ * ```
+ */
+declare function bindClasses(el: HTMLElement, classes: Record<string, () => boolean>): () => void;
+/**
+ * Reactively bind a CSS property to a value.
+ *
+ * ```ts
+ * bindStyle(el, 'color', () => textColor());
+ * bindStyle(el, 'font-size', () => `${fontSize()}px`);
+ * ```
+ */
+declare function bindStyle(el: HTMLElement, property: string, value: () => string | number | null): () => void;
+/**
+ * Bind multiple style properties at once.
+ *
+ * ```ts
+ * bindStyles(el, {
+ *   color: () => color(),
+ *   'font-size': () => `${size()}px`,
+ *   opacity: () => isVisible() ? 1 : 0,
+ * });
+ * ```
+ */
+declare function bindStyles(el: HTMLElement, styles: Record<string, () => string | number | null>): () => void;
+
+export { type EventModifiers, bindClass, bindClasses, bindDimensions, bindElement, bindGroup, bindGroupItem, bindScroll, bindStyle, bindStyles, onEvent, withModifiers };

package/dist/event-modifiers.d.ts

@@ -0,0 +1,130 @@
+import { R as ReadonlySignal, S as Signal } from './signals-DionyGGY.js';
+
+/**
+ * Event modifiers and extended bind/class/style directives.
+ *
+ * Modifiers: onClick|preventDefault|stopPropagation|once|self|capture
+ * Extended binds: bind:clientWidth, bind:scrollY, bind:group, bind:this
+ * Class directive: class:active={isActive}
+ * Style directive: style:color={textColor}
+ */
+
+interface EventModifiers {
+    preventDefault?: boolean;
+    stopPropagation?: boolean;
+    stopImmediatePropagation?: boolean;
+    once?: boolean;
+    capture?: boolean;
+    passive?: boolean;
+    self?: boolean;
+}
+/**
+ * Wrap an event handler with modifiers.
+ *
+ * ```ts
+ * const handler = withModifiers(onClick, {
+ *   preventDefault: true,
+ *   stopPropagation: true,
+ *   once: true,
+ * });
+ * el.addEventListener('click', handler);
+ * ```
+ */
+declare function withModifiers<E extends Event>(handler: (e: E) => void, modifiers: EventModifiers): (e: E) => void;
+/**
+ * Attach an event handler with modifiers to an element.
+ *
+ * ```ts
+ * onEvent(el, 'click', handler, { preventDefault: true, once: true });
+ * ```
+ */
+declare function onEvent<K extends keyof HTMLElementEventMap>(el: HTMLElement, event: K, handler: (e: HTMLElementEventMap[K]) => void, modifiers?: EventModifiers): () => void;
+/**
+ * Bind element dimensions to signals (read-only, auto-updating).
+ *
+ * ```ts
+ * const { width, height } = bindDimensions(el);
+ * width(); // tracks clientWidth
+ * ```
+ */
+declare function bindDimensions(el: HTMLElement): {
+    width: ReadonlySignal<number>;
+    height: ReadonlySignal<number>;
+};
+/**
+ * Bind scroll position to signals.
+ *
+ * ```ts
+ * const { scrollX, scrollY } = bindScroll(el);
+ * // or for window:
+ * const { scrollX, scrollY } = bindScroll();
+ * ```
+ */
+declare function bindScroll(el?: HTMLElement): {
+    scrollX: Signal<number>;
+    scrollY: Signal<number>;
+};
+/**
+ * Bind a signal to an element reference (like bind:this in Svelte).
+ *
+ * ```ts
+ * const myRef = bindElement<HTMLInputElement>();
+ * // In render: myRef.set(inputEl);
+ * myRef()?.focus();
+ * ```
+ */
+declare function bindElement<T extends HTMLElement = HTMLElement>(): Signal<T | null>;
+/**
+ * Bind a group of radio/checkbox inputs to a signal.
+ *
+ * ```ts
+ * const selected = bindGroup<string>('color');
+ * // Apply to each radio: bindGroupItem(radioEl, selected, 'red');
+ * ```
+ */
+declare function bindGroup<T>(name: string): Signal<T | null>;
+declare function bindGroupItem<T>(el: HTMLInputElement, group: Signal<T | null>, value: T): void;
+/**
+ * Conditionally apply a CSS class based on a reactive condition.
+ *
+ * ```ts
+ * bindClass(el, 'active', () => isActive());
+ * bindClass(el, 'disabled', () => isDisabled());
+ * ```
+ */
+declare function bindClass(el: HTMLElement, className: string, condition: () => boolean): () => void;
+/**
+ * Apply multiple conditional classes at once.
+ *
+ * ```ts
+ * bindClasses(el, {
+ *   active: () => isActive(),
+ *   disabled: () => isDisabled(),
+ *   'text-bold': () => isBold(),
+ * });
+ * ```
+ */
+declare function bindClasses(el: HTMLElement, classes: Record<string, () => boolean>): () => void;
+/**
+ * Reactively bind a CSS property to a value.
+ *
+ * ```ts
+ * bindStyle(el, 'color', () => textColor());
+ * bindStyle(el, 'font-size', () => `${fontSize()}px`);
+ * ```
+ */
+declare function bindStyle(el: HTMLElement, property: string, value: () => string | number | null): () => void;
+/**
+ * Bind multiple style properties at once.
+ *
+ * ```ts
+ * bindStyles(el, {
+ *   color: () => color(),
+ *   'font-size': () => `${size()}px`,
+ *   opacity: () => isVisible() ? 1 : 0,
+ * });
+ * ```
+ */
+declare function bindStyles(el: HTMLElement, styles: Record<string, () => string | number | null>): () => void;
+
+export { type EventModifiers, bindClass, bindClasses, bindDimensions, bindElement, bindGroup, bindGroupItem, bindScroll, bindStyle, bindStyles, onEvent, withModifiers };

package/dist/event-modifiers.js

@@ -0,0 +1,2 @@
+export{h as bindClass,i as bindClasses,c as bindDimensions,e as bindElement,f as bindGroup,g as bindGroupItem,d as bindScroll,j as bindStyle,k as bindStyles,b as onEvent,a as withModifiers}from'./chunk-FVF3T4JJ.js';import'./chunk-YXKQTEPR.js';import'./chunk-U65WRXZC.js';//# sourceMappingURL=event-modifiers.js.map
+//# sourceMappingURL=event-modifiers.js.map

package/dist/event-modifiers.js.map

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

package/dist/flip.cjs

@@ -0,0 +1,2 @@
+'use strict';var chunkNGU2W4PD_cjs=require('./chunk-NGU2W4PD.cjs');Object.defineProperty(exports,"createFlip",{enumerable:true,get:function(){return chunkNGU2W4PD_cjs.a}});Object.defineProperty(exports,"flip",{enumerable:true,get:function(){return chunkNGU2W4PD_cjs.b}});//# sourceMappingURL=flip.cjs.map
+//# sourceMappingURL=flip.cjs.map

package/dist/flip.cjs.map

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

package/dist/flip.d.cts

@@ -0,0 +1,66 @@
+/**
+ * FLIP animations for list reordering.
+ *
+ * First-Last-Invert-Play: measure element positions before and after
+ * a DOM change, then animate from old to new positions.
+ *
+ * ```ts
+ * const flip = createFlip(listContainer, {
+ *   duration: 300,
+ *   easing: 'cubic-bezier(0.2, 0, 0, 1)',
+ * });
+ *
+ * // Before changing the list:
+ * flip.measure();
+ * // Change the DOM (reorder, add, remove)
+ * items.set(newOrder);
+ * // Animate:
+ * flip.animate();
+ * ```
+ */
+interface FlipOptions {
+    /** Animation duration in ms (default: 300) */
+    duration?: number;
+    /** CSS easing (default: 'cubic-bezier(0.2, 0, 0, 1)') */
+    easing?: string;
+    /** Delay in ms */
+    delay?: number;
+    /** Only animate elements matching this selector */
+    selector?: string;
+    /** Key attribute to track elements across reorders (default: 'data-key') */
+    keyAttribute?: string;
+    /** Callback when animation completes */
+    onComplete?: () => void;
+}
+interface FlipController {
+    /** Measure current positions (call BEFORE DOM change) */
+    measure(): void;
+    /** Animate from measured positions to current (call AFTER DOM change) */
+    animate(): Promise<void>;
+    /** Measure and animate in one step using a callback */
+    flip(update: () => void): Promise<void>;
+}
+/**
+ * Create a FLIP animation controller for a container.
+ *
+ * ```ts
+ * const flip = createFlip(container);
+ * flip.flip(() => {
+ *   // reorder DOM elements here
+ *   container.appendChild(container.firstChild); // move first to last
+ * });
+ * ```
+ */
+declare function createFlip(container: HTMLElement, options?: FlipOptions): FlipController;
+/**
+ * One-shot FLIP animation helper.
+ *
+ * ```ts
+ * await flip(container, () => {
+ *   // reorder items
+ * }, { duration: 300 });
+ * ```
+ */
+declare function flip(container: HTMLElement, update: () => void, options?: FlipOptions): Promise<void>;
+
+export { type FlipController, type FlipOptions, createFlip, flip };

package/dist/flip.d.ts

@@ -0,0 +1,66 @@
+/**
+ * FLIP animations for list reordering.
+ *
+ * First-Last-Invert-Play: measure element positions before and after
+ * a DOM change, then animate from old to new positions.
+ *
+ * ```ts
+ * const flip = createFlip(listContainer, {
+ *   duration: 300,
+ *   easing: 'cubic-bezier(0.2, 0, 0, 1)',
+ * });
+ *
+ * // Before changing the list:
+ * flip.measure();
+ * // Change the DOM (reorder, add, remove)
+ * items.set(newOrder);
+ * // Animate:
+ * flip.animate();
+ * ```
+ */
+interface FlipOptions {
+    /** Animation duration in ms (default: 300) */
+    duration?: number;
+    /** CSS easing (default: 'cubic-bezier(0.2, 0, 0, 1)') */
+    easing?: string;
+    /** Delay in ms */
+    delay?: number;
+    /** Only animate elements matching this selector */
+    selector?: string;
+    /** Key attribute to track elements across reorders (default: 'data-key') */
+    keyAttribute?: string;
+    /** Callback when animation completes */
+    onComplete?: () => void;
+}
+interface FlipController {
+    /** Measure current positions (call BEFORE DOM change) */
+    measure(): void;
+    /** Animate from measured positions to current (call AFTER DOM change) */
+    animate(): Promise<void>;
+    /** Measure and animate in one step using a callback */
+    flip(update: () => void): Promise<void>;
+}
+/**
+ * Create a FLIP animation controller for a container.
+ *
+ * ```ts
+ * const flip = createFlip(container);
+ * flip.flip(() => {
+ *   // reorder DOM elements here
+ *   container.appendChild(container.firstChild); // move first to last
+ * });
+ * ```
+ */
+declare function createFlip(container: HTMLElement, options?: FlipOptions): FlipController;
+/**
+ * One-shot FLIP animation helper.
+ *
+ * ```ts
+ * await flip(container, () => {
+ *   // reorder items
+ * }, { duration: 300 });
+ * ```
+ */
+declare function flip(container: HTMLElement, update: () => void, options?: FlipOptions): Promise<void>;
+
+export { type FlipController, type FlipOptions, createFlip, flip };

package/dist/flip.js

@@ -0,0 +1,2 @@
+export{a as createFlip,b as flip}from'./chunk-JFLZJPVN.js';//# sourceMappingURL=flip.js.map
+//# sourceMappingURL=flip.js.map

package/dist/flip.js.map

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

package/dist/head.cjs

@@ -0,0 +1,2 @@
+'use strict';var chunkFVWHMFX6_cjs=require('./chunk-FVWHMFX6.cjs');require('./chunk-XWVNLE2W.cjs'),require('./chunk-IQGSDFBI.cjs'),require('./chunk-PPNEAFKE.cjs'),require('./chunk-WOZWFMOK.cjs'),require('./chunk-XPLIEN2G.cjs');Object.defineProperty(exports,"collectSSRHead",{enumerable:true,get:function(){return chunkFVWHMFX6_cjs.a}});Object.defineProperty(exports,"renderHeadToString",{enumerable:true,get:function(){return chunkFVWHMFX6_cjs.b}});Object.defineProperty(exports,"useHead",{enumerable:true,get:function(){return chunkFVWHMFX6_cjs.c}});//# sourceMappingURL=head.cjs.map
+//# sourceMappingURL=head.cjs.map

package/dist/head.cjs.map

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

package/dist/head.d.cts

@@ -0,0 +1,70 @@
+/**
+ * Document head management.
+ *
+ * Provides Title, Meta, and Head components for managing
+ * <head> content declaratively. SSR-compatible — on the server,
+ * collects tags; on the client, directly mutates the DOM.
+ *
+ * ```ts
+ * // In any component:
+ * useHead({
+ *   title: 'My Page',
+ *   meta: [
+ *     { name: 'description', content: 'Page description' },
+ *     { property: 'og:title', content: 'My Page' },
+ *   ],
+ *   link: [
+ *     { rel: 'canonical', href: 'https://example.com/page' },
+ *   ],
+ * });
+ * ```
+ */
+interface HeadConfig {
+    /** Document title */
+    title?: string;
+    /** Title template — use %s as placeholder */
+    titleTemplate?: string;
+    /** Meta tags */
+    meta?: MetaTag[];
+    /** Link tags */
+    link?: LinkTag[];
+    /** Script tags */
+    script?: ScriptTag[];
+    /** HTML attributes */
+    htmlAttrs?: Record<string, string>;
+    /** Body attributes */
+    bodyAttrs?: Record<string, string>;
+}
+interface MetaTag {
+    name?: string;
+    property?: string;
+    httpEquiv?: string;
+    content: string;
+}
+interface LinkTag {
+    rel: string;
+    href: string;
+    type?: string;
+    crossorigin?: string;
+}
+interface ScriptTag {
+    src?: string;
+    type?: string;
+    async?: boolean;
+    defer?: boolean;
+    innerHTML?: string;
+}
+/** @internal — collect head tags during SSR */
+declare function collectSSRHead(): HeadConfig[];
+/** Render collected head tags to HTML string (for SSR) */
+declare function renderHeadToString(configs?: HeadConfig[] | null): string;
+/**
+ * Declaratively manage document head tags.
+ * Call inside defineComponent() setup.
+ *
+ * Tags are automatically cleaned up when the component unmounts.
+ * Reactive values (signals) in the config trigger updates.
+ */
+declare function useHead(config: HeadConfig | (() => HeadConfig)): () => void;
+
+export { type HeadConfig, type LinkTag, type MetaTag, type ScriptTag, collectSSRHead, renderHeadToString, useHead };