kerfjs 0.3.1 → 0.5.0

package/dist/jsx-runtime.d.ts

@@ -1,3 +1,624 @@
+/**
+ * JSX intrinsic-element types — kerf's per-tag attribute contracts.
+ *
+ * Replaces the previous `[elemName: string]: Record<string, unknown>`
+ * catch-all that allowed any tag and any prop. Now: known tags get focused
+ * attribute interfaces (typos fail to compile); unknown tags require
+ * declaration merging to opt in.
+ *
+ * Coverage is intentionally focused, not exhaustive. The most common ~30
+ * HTML elements + the SVG primitives that make up `toElement`'s fragment
+ * set are typed in detail. Rare attributes can be added in follow-ups, or
+ * extended on a per-project basis via declaration merging into the
+ * `kerfjs/jsx-runtime` JSX namespace (KF-100):
+ *
+ *     import type { KerfBaseAttrs, KerfCustomElement } from 'kerfjs/jsx-runtime';
+ *
+ *     declare module 'kerfjs/jsx-runtime' {
+ *       namespace JSX {
+ *         interface IntrinsicElements {
+ *           'my-element': KerfCustomElement & { foo?: string };
+ *         }
+ *       }
+ *     }
+ *
+ * `IntrinsicElements` in `jsx-runtime` is an **interface** that extends the
+ * one defined here, which is what makes the merge above work — type aliases
+ * (the previous shape) couldn't be merged.
+ *
+ * Every attribute value is `AttrValue` — string / number / boolean / null /
+ * undefined / `SafeHtml`. Event-handler props (`onClick` etc.) are
+ * deliberately omitted: kerf renders to strings, so inline handlers do
+ * nothing. Use `delegate()` / `delegateCapture()` instead.
+ */
+
+/** Every kerf attribute value resolves to one of these. */
+type AttrValue = string | number | boolean | null | undefined | SafeHtml;
+/** A typed-narrowing helper: `AttrLike<'a'|'b'>` accepts the literals plus the runtime fall-throughs. */
+type AttrLike<T = string> = T | SafeHtml | null | undefined;
+/**
+ * `data-*` and `aria-*` index signatures. Applied via `KerfBaseAttrs` so
+ * every typed element accepts them without per-element enumeration.
+ */
+interface DataAriaAttrs {
+    [k: `data-${string}`]: AttrValue;
+    [k: `aria-${string}`]: AttrValue;
+}
+/** Attributes valid on essentially every HTML element. */
+interface KerfBaseAttrs extends DataAriaAttrs {
+    id?: AttrLike;
+    className?: AttrLike;
+    style?: AttrLike;
+    title?: AttrLike;
+    lang?: AttrLike;
+    dir?: AttrLike<'ltr' | 'rtl' | 'auto'>;
+    hidden?: AttrLike<boolean>;
+    draggable?: AttrLike<boolean>;
+    contentEditable?: AttrLike<boolean | 'true' | 'false' | 'inherit'>;
+    inputMode?: AttrLike<'none' | 'text' | 'tel' | 'url' | 'email' | 'numeric' | 'decimal' | 'search'>;
+    spellCheck?: AttrLike<boolean>;
+    tabIndex?: AttrLike<number>;
+    role?: AttrLike;
+    slot?: AttrLike;
+    is?: AttrLike;
+    autoCapitalize?: AttrLike<'off' | 'none' | 'on' | 'sentences' | 'words' | 'characters'>;
+    autoFocus?: AttrLike<boolean>;
+    accessKey?: AttrLike;
+    /** `data-morph-skip` opts a subtree out of kerf's diff. Any value (incl. `true`) is treated as set. */
+    'data-morph-skip'?: AttrValue;
+    children?: unknown;
+}
+/** Element-specific attribute interfaces. Each extends `KerfBaseAttrs`. */
+interface HTMLAnchorAttrs extends KerfBaseAttrs {
+    href?: AttrLike;
+    target?: AttrLike<'_self' | '_blank' | '_parent' | '_top'>;
+    rel?: AttrLike;
+    download?: AttrLike;
+    hrefLang?: AttrLike;
+    ping?: AttrLike;
+    referrerPolicy?: AttrLike;
+    type?: AttrLike;
+}
+interface HTMLAreaAttrs extends KerfBaseAttrs {
+    alt?: AttrLike;
+    coords?: AttrLike;
+    shape?: AttrLike<'rect' | 'circle' | 'poly' | 'default'>;
+    href?: AttrLike;
+    target?: AttrLike;
+    rel?: AttrLike;
+}
+interface HTMLImgAttrs extends KerfBaseAttrs {
+    src?: AttrLike;
+    alt?: AttrLike;
+    width?: AttrLike<number | string>;
+    height?: AttrLike<number | string>;
+    srcSet?: AttrLike;
+    sizes?: AttrLike;
+    loading?: AttrLike<'eager' | 'lazy'>;
+    decoding?: AttrLike<'sync' | 'async' | 'auto'>;
+    crossOrigin?: AttrLike<'anonymous' | 'use-credentials' | ''>;
+    referrerPolicy?: AttrLike;
+    useMap?: AttrLike;
+    fetchPriority?: AttrLike<'high' | 'low' | 'auto'>;
+}
+interface HTMLInputAttrs extends KerfBaseAttrs {
+    type?: AttrLike<'text' | 'password' | 'email' | 'number' | 'tel' | 'url' | 'search' | 'date' | 'datetime-local' | 'time' | 'month' | 'week' | 'color' | 'checkbox' | 'radio' | 'file' | 'hidden' | 'submit' | 'reset' | 'button' | 'image' | 'range'>;
+    name?: AttrLike;
+    value?: AttrLike;
+    defaultValue?: AttrLike;
+    placeholder?: AttrLike;
+    required?: AttrLike<boolean>;
+    disabled?: AttrLike<boolean>;
+    readOnly?: AttrLike<boolean>;
+    checked?: AttrLike<boolean>;
+    defaultChecked?: AttrLike<boolean>;
+    multiple?: AttrLike<boolean>;
+    pattern?: AttrLike;
+    min?: AttrLike<number | string>;
+    max?: AttrLike<number | string>;
+    step?: AttrLike<number | string>;
+    minLength?: AttrLike<number>;
+    maxLength?: AttrLike<number>;
+    size?: AttrLike<number>;
+    autoComplete?: AttrLike;
+    form?: AttrLike;
+    formAction?: AttrLike;
+    formMethod?: AttrLike<'get' | 'post' | 'dialog'>;
+    formTarget?: AttrLike;
+    formEncType?: AttrLike;
+    formNoValidate?: AttrLike<boolean>;
+    list?: AttrLike;
+    src?: AttrLike;
+    alt?: AttrLike;
+    width?: AttrLike<number | string>;
+    height?: AttrLike<number | string>;
+    accept?: AttrLike;
+    capture?: AttrLike<boolean | 'user' | 'environment'>;
+}
+interface HTMLButtonAttrs extends KerfBaseAttrs {
+    type?: AttrLike<'button' | 'submit' | 'reset'>;
+    name?: AttrLike;
+    value?: AttrLike;
+    disabled?: AttrLike<boolean>;
+    form?: AttrLike;
+    formAction?: AttrLike;
+    formMethod?: AttrLike;
+    formTarget?: AttrLike;
+    formEncType?: AttrLike;
+    formNoValidate?: AttrLike<boolean>;
+}
+interface HTMLFormAttrs extends KerfBaseAttrs {
+    action?: AttrLike;
+    method?: AttrLike<'get' | 'post' | 'dialog'>;
+    encType?: AttrLike;
+    target?: AttrLike;
+    name?: AttrLike;
+    noValidate?: AttrLike<boolean>;
+    acceptCharset?: AttrLike;
+    autoComplete?: AttrLike;
+}
+interface HTMLLabelAttrs extends KerfBaseAttrs {
+    htmlFor?: AttrLike;
+    form?: AttrLike;
+}
+interface HTMLOptionAttrs extends KerfBaseAttrs {
+    value?: AttrLike;
+    selected?: AttrLike<boolean>;
+    defaultSelected?: AttrLike<boolean>;
+    disabled?: AttrLike<boolean>;
+    label?: AttrLike;
+}
+interface HTMLOptgroupAttrs extends KerfBaseAttrs {
+    label?: AttrLike;
+    disabled?: AttrLike<boolean>;
+}
+interface HTMLSelectAttrs extends KerfBaseAttrs {
+    name?: AttrLike;
+    value?: AttrLike;
+    defaultValue?: AttrLike;
+    multiple?: AttrLike<boolean>;
+    required?: AttrLike<boolean>;
+    disabled?: AttrLike<boolean>;
+    size?: AttrLike<number>;
+    form?: AttrLike;
+    autoComplete?: AttrLike;
+}
+interface HTMLTextareaAttrs extends KerfBaseAttrs {
+    name?: AttrLike;
+    value?: AttrLike;
+    defaultValue?: AttrLike;
+    placeholder?: AttrLike;
+    rows?: AttrLike<number>;
+    cols?: AttrLike<number>;
+    required?: AttrLike<boolean>;
+    disabled?: AttrLike<boolean>;
+    readOnly?: AttrLike<boolean>;
+    maxLength?: AttrLike<number>;
+    minLength?: AttrLike<number>;
+    wrap?: AttrLike<'hard' | 'soft' | 'off'>;
+    autoComplete?: AttrLike;
+    form?: AttrLike;
+}
+interface HTMLTableAttrs extends KerfBaseAttrs {
+    cellPadding?: AttrLike<number | string>;
+    cellSpacing?: AttrLike<number | string>;
+}
+interface HTMLTableCellAttrs extends KerfBaseAttrs {
+    colSpan?: AttrLike<number>;
+    rowSpan?: AttrLike<number>;
+    headers?: AttrLike;
+    scope?: AttrLike<'row' | 'col' | 'rowgroup' | 'colgroup'>;
+    abbr?: AttrLike;
+}
+interface HTMLColAttrs extends KerfBaseAttrs {
+    span?: AttrLike<number>;
+}
+interface HTMLMetaAttrs extends KerfBaseAttrs {
+    name?: AttrLike;
+    content?: AttrLike;
+    charSet?: AttrLike;
+    httpEquiv?: AttrLike;
+}
+interface HTMLLinkAttrs extends KerfBaseAttrs {
+    href?: AttrLike;
+    rel?: AttrLike;
+    type?: AttrLike;
+    media?: AttrLike;
+    sizes?: AttrLike;
+    hrefLang?: AttrLike;
+    as?: AttrLike;
+    crossOrigin?: AttrLike;
+    integrity?: AttrLike;
+    referrerPolicy?: AttrLike;
+    fetchPriority?: AttrLike<'high' | 'low' | 'auto'>;
+}
+interface HTMLScriptAttrs extends KerfBaseAttrs {
+    src?: AttrLike;
+    type?: AttrLike;
+    async?: AttrLike<boolean>;
+    defer?: AttrLike<boolean>;
+    noModule?: AttrLike<boolean>;
+    integrity?: AttrLike;
+    crossOrigin?: AttrLike;
+    referrerPolicy?: AttrLike;
+    nonce?: AttrLike;
+}
+interface HTMLStyleAttrs extends KerfBaseAttrs {
+    type?: AttrLike;
+    media?: AttrLike;
+    scoped?: AttrLike<boolean>;
+}
+interface HTMLIframeAttrs extends KerfBaseAttrs {
+    src?: AttrLike;
+    srcDoc?: AttrLike;
+    name?: AttrLike;
+    sandbox?: AttrLike;
+    allow?: AttrLike;
+    allowFullScreen?: AttrLike<boolean>;
+    width?: AttrLike<number | string>;
+    height?: AttrLike<number | string>;
+    loading?: AttrLike<'eager' | 'lazy'>;
+    referrerPolicy?: AttrLike;
+}
+interface HTMLMediaAttrs extends KerfBaseAttrs {
+    src?: AttrLike;
+    controls?: AttrLike<boolean>;
+    autoPlay?: AttrLike<boolean>;
+    loop?: AttrLike<boolean>;
+    muted?: AttrLike<boolean>;
+    preload?: AttrLike<'auto' | 'metadata' | 'none' | ''>;
+    crossOrigin?: AttrLike;
+}
+interface HTMLVideoAttrs extends HTMLMediaAttrs {
+    poster?: AttrLike;
+    width?: AttrLike<number | string>;
+    height?: AttrLike<number | string>;
+    playsInline?: AttrLike<boolean>;
+}
+interface HTMLSourceAttrs extends KerfBaseAttrs {
+    src?: AttrLike;
+    type?: AttrLike;
+    srcSet?: AttrLike;
+    sizes?: AttrLike;
+    media?: AttrLike;
+}
+interface HTMLTrackAttrs extends KerfBaseAttrs {
+    src?: AttrLike;
+    kind?: AttrLike<'subtitles' | 'captions' | 'descriptions' | 'chapters' | 'metadata'>;
+    srcLang?: AttrLike;
+    label?: AttrLike;
+    default?: AttrLike<boolean>;
+}
+interface HTMLDetailsAttrs extends KerfBaseAttrs {
+    open?: AttrLike<boolean>;
+}
+interface HTMLDialogAttrs extends KerfBaseAttrs {
+    open?: AttrLike<boolean>;
+}
+interface HTMLOlAttrs extends KerfBaseAttrs {
+    reversed?: AttrLike<boolean>;
+    start?: AttrLike<number>;
+    type?: AttrLike<'1' | 'a' | 'A' | 'i' | 'I'>;
+}
+interface HTMLLiAttrs extends KerfBaseAttrs {
+    value?: AttrLike<number>;
+}
+interface HTMLProgressAttrs extends KerfBaseAttrs {
+    value?: AttrLike<number>;
+    max?: AttrLike<number>;
+}
+interface HTMLMeterAttrs extends KerfBaseAttrs {
+    value?: AttrLike<number>;
+    min?: AttrLike<number>;
+    max?: AttrLike<number>;
+    low?: AttrLike<number>;
+    high?: AttrLike<number>;
+    optimum?: AttrLike<number>;
+}
+interface HTMLCanvasAttrs extends KerfBaseAttrs {
+    width?: AttrLike<number | string>;
+    height?: AttrLike<number | string>;
+}
+interface HTMLBaseAttrs extends KerfBaseAttrs {
+    href?: AttrLike;
+    target?: AttrLike;
+}
+interface HTMLBlockquoteAttrs extends KerfBaseAttrs {
+    cite?: AttrLike;
+}
+interface HTMLQAttrs extends KerfBaseAttrs {
+    cite?: AttrLike;
+}
+/**
+ * SVG attribute set — focused on the elements `toElement`'s SVG path supports
+ * (the `SVG_FRAGMENT_TAGS` set in `src/toElement.ts`). Presentation attrs are
+ * shared via `SVGPresentationAttrs`.
+ */
+interface SVGPresentationAttrs {
+    fill?: AttrLike;
+    fillOpacity?: AttrLike<number | string>;
+    fillRule?: AttrLike<'nonzero' | 'evenodd' | 'inherit'>;
+    stroke?: AttrLike;
+    strokeWidth?: AttrLike<number | string>;
+    strokeOpacity?: AttrLike<number | string>;
+    strokeLinecap?: AttrLike<'butt' | 'round' | 'square' | 'inherit'>;
+    strokeLinejoin?: AttrLike<'miter' | 'round' | 'bevel' | 'inherit'>;
+    strokeDasharray?: AttrLike;
+    strokeDashoffset?: AttrLike<number | string>;
+    strokeMiterlimit?: AttrLike<number | string>;
+    opacity?: AttrLike<number | string>;
+    vectorEffect?: AttrLike;
+    clipPath?: AttrLike;
+    clipRule?: AttrLike;
+    mask?: AttrLike;
+    filter?: AttrLike;
+    pointerEvents?: AttrLike;
+    shapeRendering?: AttrLike;
+    paintOrder?: AttrLike;
+    color?: AttrLike;
+    display?: AttrLike;
+    visibility?: AttrLike;
+}
+interface SVGCommonAttrs extends DataAriaAttrs, SVGPresentationAttrs {
+    id?: AttrLike;
+    className?: AttrLike;
+    style?: AttrLike;
+    transform?: AttrLike;
+    tabIndex?: AttrLike<number>;
+    role?: AttrLike;
+    xmlns?: AttrLike;
+    xmlnsXlink?: AttrLike;
+    children?: unknown;
+}
+interface SVGSvgAttrs extends SVGCommonAttrs {
+    width?: AttrLike<number | string>;
+    height?: AttrLike<number | string>;
+    viewBox?: AttrLike;
+    preserveAspectRatio?: AttrLike;
+    x?: AttrLike<number | string>;
+    y?: AttrLike<number | string>;
+}
+interface SVGPathAttrs extends SVGCommonAttrs {
+    d?: AttrLike;
+    pathLength?: AttrLike<number>;
+}
+interface SVGCircleAttrs extends SVGCommonAttrs {
+    cx?: AttrLike<number | string>;
+    cy?: AttrLike<number | string>;
+    r?: AttrLike<number | string>;
+}
+interface SVGRectAttrs extends SVGCommonAttrs {
+    x?: AttrLike<number | string>;
+    y?: AttrLike<number | string>;
+    width?: AttrLike<number | string>;
+    height?: AttrLike<number | string>;
+    rx?: AttrLike<number | string>;
+    ry?: AttrLike<number | string>;
+}
+interface SVGLineAttrs extends SVGCommonAttrs {
+    x1?: AttrLike<number | string>;
+    y1?: AttrLike<number | string>;
+    x2?: AttrLike<number | string>;
+    y2?: AttrLike<number | string>;
+}
+interface SVGEllipseAttrs extends SVGCommonAttrs {
+    cx?: AttrLike<number | string>;
+    cy?: AttrLike<number | string>;
+    rx?: AttrLike<number | string>;
+    ry?: AttrLike<number | string>;
+}
+interface SVGPolyAttrs extends SVGCommonAttrs {
+    points?: AttrLike;
+}
+interface SVGTextAttrs extends SVGCommonAttrs {
+    x?: AttrLike<number | string>;
+    y?: AttrLike<number | string>;
+    dx?: AttrLike<number | string>;
+    dy?: AttrLike<number | string>;
+    textAnchor?: AttrLike<'start' | 'middle' | 'end' | 'inherit'>;
+    dominantBaseline?: AttrLike;
+    fontFamily?: AttrLike;
+    fontSize?: AttrLike<number | string>;
+    fontStyle?: AttrLike;
+    fontWeight?: AttrLike<number | string>;
+    letterSpacing?: AttrLike<number | string>;
+}
+interface SVGUseAttrs extends SVGCommonAttrs {
+    xlinkHref?: AttrLike;
+    href?: AttrLike;
+    x?: AttrLike<number | string>;
+    y?: AttrLike<number | string>;
+    width?: AttrLike<number | string>;
+    height?: AttrLike<number | string>;
+}
+interface SVGImageAttrs extends SVGCommonAttrs {
+    href?: AttrLike;
+    xlinkHref?: AttrLike;
+    x?: AttrLike<number | string>;
+    y?: AttrLike<number | string>;
+    width?: AttrLike<number | string>;
+    height?: AttrLike<number | string>;
+    preserveAspectRatio?: AttrLike;
+}
+interface SVGForeignObjectAttrs extends SVGCommonAttrs {
+    x?: AttrLike<number | string>;
+    y?: AttrLike<number | string>;
+    width?: AttrLike<number | string>;
+    height?: AttrLike<number | string>;
+}
+/**
+ * Loose attribute set for custom elements / web components. Use via
+ * declaration merging into the `kerfjs/jsx-runtime` JSX namespace if your
+ * project uses tags not enumerated below:
+ *
+ *     import type { KerfCustomElement } from 'kerfjs/jsx-runtime';
+ *
+ *     declare module 'kerfjs/jsx-runtime' {
+ *       namespace JSX {
+ *         interface IntrinsicElements {
+ *           'my-component': KerfCustomElement & { foo?: string };
+ *         }
+ *       }
+ *     }
+ *
+ * `KerfCustomElement` is re-exported from `kerfjs/jsx-runtime` (KF-100) so
+ * apps don't need to reach into the internal `kerfjs/jsx-types` path.
+ */
+interface KerfCustomElement extends KerfBaseAttrs {
+    [k: string]: AttrValue | unknown;
+}
+interface IntrinsicElements {
+    html: KerfBaseAttrs;
+    head: KerfBaseAttrs;
+    body: KerfBaseAttrs;
+    div: KerfBaseAttrs;
+    span: KerfBaseAttrs;
+    section: KerfBaseAttrs;
+    article: KerfBaseAttrs;
+    header: KerfBaseAttrs;
+    footer: KerfBaseAttrs;
+    main: KerfBaseAttrs;
+    nav: KerfBaseAttrs;
+    aside: KerfBaseAttrs;
+    h1: KerfBaseAttrs;
+    h2: KerfBaseAttrs;
+    h3: KerfBaseAttrs;
+    h4: KerfBaseAttrs;
+    h5: KerfBaseAttrs;
+    h6: KerfBaseAttrs;
+    p: KerfBaseAttrs;
+    hr: KerfBaseAttrs;
+    br: KerfBaseAttrs;
+    pre: KerfBaseAttrs;
+    blockquote: HTMLBlockquoteAttrs;
+    q: HTMLQAttrs;
+    ol: HTMLOlAttrs;
+    ul: KerfBaseAttrs;
+    li: HTMLLiAttrs;
+    dl: KerfBaseAttrs;
+    dt: KerfBaseAttrs;
+    dd: KerfBaseAttrs;
+    figure: KerfBaseAttrs;
+    figcaption: KerfBaseAttrs;
+    a: HTMLAnchorAttrs;
+    em: KerfBaseAttrs;
+    strong: KerfBaseAttrs;
+    small: KerfBaseAttrs;
+    s: KerfBaseAttrs;
+    cite: KerfBaseAttrs;
+    code: KerfBaseAttrs;
+    kbd: KerfBaseAttrs;
+    samp: KerfBaseAttrs;
+    var: KerfBaseAttrs;
+    sub: KerfBaseAttrs;
+    sup: KerfBaseAttrs;
+    i: KerfBaseAttrs;
+    b: KerfBaseAttrs;
+    u: KerfBaseAttrs;
+    mark: KerfBaseAttrs;
+    abbr: KerfBaseAttrs;
+    time: KerfBaseAttrs & {
+        dateTime?: AttrLike;
+    };
+    img: HTMLImgAttrs;
+    picture: KerfBaseAttrs;
+    source: HTMLSourceAttrs;
+    track: HTMLTrackAttrs;
+    iframe: HTMLIframeAttrs;
+    embed: KerfBaseAttrs & {
+        src?: AttrLike;
+        type?: AttrLike;
+        width?: AttrLike<number | string>;
+        height?: AttrLike<number | string>;
+    };
+    object: KerfBaseAttrs & {
+        data?: AttrLike;
+        type?: AttrLike;
+        name?: AttrLike;
+        width?: AttrLike<number | string>;
+        height?: AttrLike<number | string>;
+    };
+    audio: HTMLMediaAttrs;
+    video: HTMLVideoAttrs;
+    canvas: HTMLCanvasAttrs;
+    area: HTMLAreaAttrs;
+    map: KerfBaseAttrs & {
+        name?: AttrLike;
+    };
+    form: HTMLFormAttrs;
+    input: HTMLInputAttrs;
+    button: HTMLButtonAttrs;
+    select: HTMLSelectAttrs;
+    optgroup: HTMLOptgroupAttrs;
+    option: HTMLOptionAttrs;
+    textarea: HTMLTextareaAttrs;
+    label: HTMLLabelAttrs;
+    fieldset: KerfBaseAttrs & {
+        name?: AttrLike;
+        form?: AttrLike;
+        disabled?: AttrLike<boolean>;
+    };
+    legend: KerfBaseAttrs;
+    datalist: KerfBaseAttrs;
+    output: KerfBaseAttrs & {
+        name?: AttrLike;
+        form?: AttrLike;
+        htmlFor?: AttrLike;
+    };
+    progress: HTMLProgressAttrs;
+    meter: HTMLMeterAttrs;
+    table: HTMLTableAttrs;
+    caption: KerfBaseAttrs;
+    colgroup: HTMLColAttrs;
+    col: HTMLColAttrs;
+    thead: KerfBaseAttrs;
+    tbody: KerfBaseAttrs;
+    tfoot: KerfBaseAttrs;
+    tr: KerfBaseAttrs;
+    td: HTMLTableCellAttrs;
+    th: HTMLTableCellAttrs;
+    meta: HTMLMetaAttrs;
+    link: HTMLLinkAttrs;
+    script: HTMLScriptAttrs;
+    style: HTMLStyleAttrs;
+    base: HTMLBaseAttrs;
+    title: KerfBaseAttrs;
+    details: HTMLDetailsAttrs;
+    summary: KerfBaseAttrs;
+    dialog: HTMLDialogAttrs;
+    template: KerfBaseAttrs;
+    slot: KerfBaseAttrs & {
+        name?: AttrLike;
+    };
+    svg: SVGSvgAttrs;
+    g: SVGCommonAttrs;
+    defs: SVGCommonAttrs;
+    symbol: SVGCommonAttrs;
+    use: SVGUseAttrs;
+    path: SVGPathAttrs;
+    circle: SVGCircleAttrs;
+    rect: SVGRectAttrs;
+    line: SVGLineAttrs;
+    ellipse: SVGEllipseAttrs;
+    polygon: SVGPolyAttrs;
+    polyline: SVGPolyAttrs;
+    text: SVGTextAttrs;
+    tspan: SVGTextAttrs;
+    image: SVGImageAttrs;
+    foreignObject: SVGForeignObjectAttrs;
+    clipPath: SVGCommonAttrs;
+    mask: SVGCommonAttrs;
+    pattern: SVGCommonAttrs;
+    marker: SVGCommonAttrs;
+    linearGradient: SVGCommonAttrs;
+    radialGradient: SVGCommonAttrs;
+    stop: SVGCommonAttrs & {
+        offset?: AttrLike<number | string>;
+        stopColor?: AttrLike;
+        stopOpacity?: AttrLike<number | string>;
+    };
+}
+
 /**
  * `Segment` — kerf's structured render output.
  *
@@ -41,7 +662,45 @@ interface ListSegment {
     kind: 'list';
     id: string;
     items: ListItem[];
+    /**
+     * Optional granular patches (KF-92). When present, the list reconciler
+     * applies these directly to the existing binding instead of doing a
+     * full classify+reconcile pass. Emitted by `each()` when bound to an
+     * `arraySignal`. Mutually exclusive with the `items` snapshot in the
+     * sense that the snapshot is treated as informational/fall-back when
+     * patches are present.
+     */
+    patches?: ArrayPatchInternal[];
 }
+/**
+ * Internal patch shape used inside list segments. Mirrors `ArrayPatch<T>`
+ * from `array-signal.ts` but typed against `object` so the segment layer
+ * doesn't need to be generic. `update` / `insert` patches carry the row's
+ * pre-rendered HTML — `each()` renders them at JSX-evaluation time inside a
+ * try/catch so a throwing render falls back to the snapshot path (KF-99)
+ * instead of leaving the signal and DOM divergent.
+ */
+type ArrayPatchInternal = {
+    type: 'update';
+    index: number;
+    item: object;
+    html: string;
+} | {
+    type: 'insert';
+    index: number;
+    item: object;
+    html: string;
+} | {
+    type: 'remove';
+    index: number;
+} | {
+    type: 'move';
+    from: number;
+    to: number;
+} | {
+    type: 'replace';
+    items: readonly object[];
+};
 interface MixedSegment {
     kind: 'mixed';
     parts: Segment[];
@@ -93,6 +752,19 @@ declare function raw(html: string): SafeHtml;
  * `each()` so the JSX runtime is the sole owner of `SafeHtml` construction.
  */
 declare function listSafeHtml(id: string, items: ListSegment['items']): SafeHtml;
+/**
+ * Internal: build a `SafeHtml` representing a granular list segment with
+ * patches (KF-92). The reconciler applies the patches to the existing
+ * binding directly, skipping the per-item iteration that the snapshot
+ * `listSafeHtml` requires. `items` is included for fall-through paths
+ * (toString during SSR, fall-back when the binding doesn't exist yet).
+ *
+ * Patch HTML is rendered upstream (in `each()`) inside a try/catch — see
+ * KF-99 — so by the time we get here every `update` / `insert` patch
+ * already carries a `html` string, and the reconciler does no further
+ * row rendering.
+ */
+declare function granularListSafeHtml(id: string, items: ListSegment['items'], patches: NonNullable<ListSegment['patches']>): SafeHtml;
 type Child = SafeHtml | string | number | boolean | null | undefined;
 type Children = Child | Children[];
 interface Props {
@@ -109,9 +781,8 @@ declare namespace JSX {
     interface ElementChildrenAttribute {
         children: unknown;
     }
-    interface IntrinsicElements {
-        [elemName: string]: Record<string, unknown>;
+    interface IntrinsicElements extends IntrinsicElements {
     }
 }
 
-export { Fragment, JSX, SafeHtml, isSafeHtml, jsx, jsx as jsxDEV, jsx as jsxs, listSafeHtml, raw };
+export { type AttrLike, type AttrValue, type DataAriaAttrs, Fragment, JSX, type KerfBaseAttrs, type KerfCustomElement, SafeHtml, granularListSafeHtml, isSafeHtml, jsx, jsx as jsxDEV, jsx as jsxs, listSafeHtml, raw };

package/dist/jsx-runtime.js

@@ -1,3 +1,3 @@
-export { Fragment, SafeHtml, isSafeHtml, jsx, jsx as jsxDEV, jsx as jsxs, listSafeHtml, raw } from './chunk-WK5D3OO7.js';
+export { Fragment, SafeHtml, granularListSafeHtml, isSafeHtml, jsx, jsx as jsxDEV, jsx as jsxs, listSafeHtml, raw } from './chunk-WYJTMERY.js';
 //# sourceMappingURL=jsx-runtime.js.map
 //# sourceMappingURL=jsx-runtime.js.map

package/dist/testing.js

@@ -1,3 +1,4 @@
-export { clearStoreRegistry } from './chunk-IZJIKRCE.js';
+export { clearStoreRegistry } from './chunk-GQGJFCWL.js';
+import './chunk-FN2ID4QO.js';
 //# sourceMappingURL=testing.js.map
 //# sourceMappingURL=testing.js.map