import type { Tonic } from './index.js';
/**
 * Render a Tonic component instance to an HTML string.
 *
 * This function takes a Tonic component instance, calls its render method,
 * and recursively processes any nested Tonic components to produce a complete
 * HTML string suitable for server-side rendering.
 *
 * @param component - A Tonic component instance to render
 * @returns A promise that resolves to an HTML string
 *
 * @example
 * ```ts
 * import { render } from '@substrate-system/tonic/render-to-string'
 * import { MyComponent } from './components'
 *
 * const component = new MyComponent()
 * const html = await render(component)
 * console.log(html) // <div>...</div>
 * ```
 */
export declare function render(component: InstanceType<typeof Tonic>): Promise<string>;
/**
 * Generate a `<script>` tag containing serialized hydration
 * state.
 *
 * Embed this in your HTML page so the client-side `hydrate`
 * function can read it. The state object keys should be
 * component `id` attributes, mapping to the props for that
 * component.
 *
 * @example
 * ```ts
 * const script = getHydrationScript({
 *     app: { title: 'Hello', items: [1, 2, 3] }
 * })
 * // <script type="application/json" data-tonic-ssr>
 * //   {"app":{"title":"Hello","items":[1,2,3]}}
 * // </script>
 * ```
 */
export declare function getHydrationScript(state: Record<string, any>): string;
/**
 * Wrap rendered component content in its custom element tag,
 * with props encoded as attributes.
 *
 * Use this to build a hydratable HTML page from
 * server-rendered content.
 *
 * @param component  The component instance that was rendered
 * @param content    The HTML string from `render(component)`
 * @param opts.id    Element `id` attribute (required for
 *                   state transfer via hydration)
 * @param opts.tagName  Override the tag name (defaults to
 *                      the class name converted to kebab-case)
 * @param opts.state    Hydration state -- if provided, a
 *                      `<script data-tonic-ssr>` tag is
 *                      appended with the serialized JSON
 *
 * @example
 * ```ts
 * import { render, toHtml } from
 *     '@substrate-system/tonic/render-to-string'
 *
 * const app = new MyApp()
 * app.props = { title: 'Hello', items: [1, 2, 3] }
 * const content = await render(app)
 *
 * const html = toHtml(app, content, {
 *     id: 'app',
 *     state: {
 *         app: { title: 'Hello', items: [1, 2, 3] }
 *     }
 * })
 * ```
 */
export declare function toHtml(component: InstanceType<typeof Tonic>, content: string, opts?: {
    id?: string;
    tagName?: string;
    state?: Record<string, any>;
}): string;
//# sourceMappingURL=render-to-string.d.ts.map