import { E as EventType, A as ActionOp } from '../types-CJtAzafC.js';
import '../lifecycle-DRSAPNpC.js';

/** Guide version — always equal to the SDK VERSION it documents. */
declare const AUTHORING_GUIDE_VERSION: string;
/**
 * Each guide section separately, keyed by its stable section id (the same id
 * used as the heading anchor in the full guide). Stable ids let the docsite
 * deep-link and let the CLI scaffold subsets.
 */
declare const AUTHORING_GUIDE_SECTIONS: Record<string, string>;
/**
 * The complete authoring guide as a single markdown document.
 */
declare const AUTHORING_GUIDE: string;

/**
 * @eeko/sdk — authoring-guide catalogs.
 *
 * Typed documentation catalogs the markdown guide (`./guide`) is assembled
 * from. Every catalog is keyed by an SDK union (`Record<EventType, …>`,
 * `Record<ActionOp, …>`) so adding an event or op WITHOUT documenting it is a
 * compile error — the guide cannot silently drift from the runtime.
 *
 * Accuracy notes (verified against the SDK source, which is the SSOT):
 *  - Handler shapes follow `runtime-bridge.ts`'s `unwrap()`: the bridge
 *    unwraps the `{type, context, payload}` wire envelope for EVERY event and
 *    passes `payload` to handlers — one rule, no per-event branching
 *    (`EekoEventMap` in `types.ts` types each handler argument as
 *    `Envelope['payload']`). Handlers never see `.context` or a nested
 *    `.payload`.
 *  - `component_mount` / `component_unmount` are SDK-local iframe lifecycle
 *    events (never on the wire); their flat payloads are emitted directly.
 */

interface EventDoc {
    /** One-line description of when the event fires. */
    summary: string;
    /** What the handler argument is (see module note above). */
    handlerShape: 'unwrapped-payload' | 'wire-envelope' | string;
    /** The handler argument's shape, field by field. */
    payloadDoc: string;
    /** A correct, minimal handler. */
    example: string;
}
declare const EVENT_CATALOG: Record<EventType, EventDoc>;
interface OpDoc {
    /** One-line description of what the op does. */
    summary: string;
    /** Parameter contract: required first, then optional. */
    params: string;
    /** A correct, minimal JSON action. */
    example: string;
}
declare const OP_CATALOG: Record<ActionOp, OpDoc>;
interface BindingKindDoc {
    kind: 'from' | 'fromVariable' | 'fromCounter' | 'literal' | 'fromBehavior';
    syntax: string;
    semantics: string;
}
declare const BINDING_KINDS: readonly BindingKindDoc[];
interface ForbiddenPattern {
    /** The literal pattern to never write. */
    pattern: string;
    /** Why it breaks. */
    why: string;
    /** What to write instead. */
    instead: string;
}
declare const FORBIDDEN_PATTERNS: readonly ForbiddenPattern[];

export { AUTHORING_GUIDE, AUTHORING_GUIDE_SECTIONS, AUTHORING_GUIDE_VERSION, BINDING_KINDS, type BindingKindDoc, EVENT_CATALOG, type EventDoc, FORBIDDEN_PATTERNS, type ForbiddenPattern, OP_CATALOG, type OpDoc };