@8ux-co/eelzap 0.11.0 → 0.11.1

package/dist/index.d.ts

@@ -208,11 +208,16 @@ interface EnumValue {
  * A CURRENCY field's value, read and written in this one shape.
  *
  * `amountMinor` is in the currency's minor unit (cents: `4800000` is
- * COP 48.000,00), an integer. `currency` is the ISO 4217 code.
+ * COP 48.000,00), an integer. `currency` is the ISO 4217 code. Reads also
+ * carry `amount`, the same value in major units (`48000`): `amountMinor`
+ * divided by ten to the currency's ISO 4217 exponent (COP and USD 2, JPY 0).
+ * Writes ignore it.
  */
 interface CurrencyValue {
     amountMinor: number;
     currency: string;
+    /** Major units, on reads: `amountMinor / 10^exponent`. */
+    amount?: number;
 }
 /**
  * Access mode for a media value.
@@ -410,6 +415,12 @@ interface CollectionSummary {
     key: string;
     name: string;
     description: string | null;
+    /**
+     * «Ruta en tu sitio»: the page an entry appears on, `/blog/{slug}`; `null`
+     * when unset. Read with a `secret_` key or a suite credential only; a
+     * `public_` key's answer does not carry it.
+     */
+    previewPath?: string | null;
     itemCount: number;
     fields?: FieldInfo[];
     sections?: SectionInfo[];
@@ -734,7 +745,7 @@ type CommentStatus = 'OPEN' | 'RESOLVED';
 /** How a change request was resolved; APPLIED also covers "changed by hand". */
 type CommentResolution = 'APPLIED' | 'DISMISSED';
 /** Where the thread was made. The API derives it from the credential. */
-type CommentSource = 'EDITOR' | 'PREVIEW' | 'SITE' | 'API' | 'MCP';
+type CommentSource = 'EDITOR' | 'PREVIEW' | 'SITE' | 'API' | 'MCP' | 'AI';
 type CommentAnchorKind = 'field' | 'dom' | 'spot';
 /** A page-normalised rectangle: every value between 0 and 1. */
 interface CommentRect {
@@ -955,7 +966,7 @@ interface CommentWriteBase {
 type CreateCommentInput = CommentRecord & CommentWriteBase & {
     isChangeRequest?: boolean;
     assigneeId?: string | null;
-    /** At most 20; TEXT, LONG_TEXT, NUMBER and URL fields. */
+    /** At most 20; TEXT, LONG_TEXT, NUMBER, URL and RICH_TEXT (an HTML string) fields. */
     proposedValues?: CommentProposedValueInput[];
 };
 /** `saveToDraft`: always a change request, no assignee, at least one proposed value. */
@@ -1124,6 +1135,7 @@ declare class CommentsResource {
  * string.
  */
 type VersionStatus = 'DRAFT' | 'PUBLISHED' | 'ARCHIVED';
+type VersionActorKind = 'PERSON' | 'ASK_ZAP' | 'API_KEY' | 'MCP' | 'SITE_KEY' | 'AI_JOB';
 /**
  * One row of an entry's history. What `list`, `createDraft`, `publishDraft`
  * and `rollback` answer with: no values.
@@ -1134,6 +1146,20 @@ interface VersionSummary {
     status: VersionStatus;
     /** The account that made the version, or null for an API key or a deleted account. */
     createdById: string | null;
+    /**
+     * What wrote the version, recorded when it was written: `PERSON` (the editor,
+     * and every version from before this field), `ASK_ZAP`, `API_KEY` (a workspace
+     * API key), `MCP` (an OAuth connection such as Claude), `SITE_KEY` (a site
+     * secret key) or `AI_JOB` (the dashboard's bulk site translation).
+     */
+    actorKind: VersionActorKind;
+    /**
+     * The API key's or connection's name as it was when the version was written
+     * (not renamed or removed with it); null for `PERSON` and `ASK_ZAP`.
+     */
+    actorName: string | null;
+    /** The OAuth client's display name ("Claude Code") for an MCP write; null otherwise. */
+    actorApp: string | null;
     /** The author's display name, or null when the account is gone. */
     authorName: string | null;
     authorAvatarUrl: string | null;
@@ -1307,6 +1333,11 @@ interface DocumentListEntry {
     key: string;
     name: string;
     description: string | null;
+    /**
+     * «Ruta en tu sitio»: the page this document is, `/nosotros`; `null` when
+     * unset. Read with a `secret_` key or a suite credential only.
+     */
+    previewPath?: string | null;
     status: string;
     updatedAt: string;
     publishedAt: string | null;
@@ -1319,6 +1350,12 @@ interface DocumentListEntry {
 interface DocumentDetail<TContent = Record<string, unknown>> {
     key: string;
     name: string;
+    /**
+     * «Ruta en tu sitio»: the page this document is, `/nosotros`; `null` when
+     * unset. Read with a `secret_` key or a suite credential only; a `public_`
+     * key's answer does not carry it.
+     */
+    previewPath?: string | null;
     status: string;
     locale: string;
     meta: DocumentMeta;
@@ -2424,7 +2461,7 @@ interface WebhookCommentData<TEntry extends WebhookCommentRef = WebhookCommentRe
     } | null;
     comments: TEntry[];
 }
-type WebhookCommentSource = 'EDITOR' | 'PREVIEW' | 'SITE' | 'API' | 'MCP';
+type WebhookCommentSource = 'EDITOR' | 'PREVIEW' | 'SITE' | 'API' | 'MCP' | 'AI';
 /** `data` of `zap.comment.created`. */
 type WebhookCommentCreatedData = WebhookCommentData<WebhookCommentRef & {
     is_change_request: boolean;
@@ -2513,4 +2550,4 @@ declare function verifyWebhookSignature(payload: string, headers: WebhookHeaders
  */
 declare function webhookChanges(payload: WebhookPayload): WebhookChange[];
 
-export { type ApiErrorDetail, type ApiErrorPayload, type CacheAdapter, type CacheStrategy, type CachedFetchOptions, type ClientConfig, type ClientDefaults, type CollectionDetail, type CollectionFieldListResponse, CollectionFieldsResource, type CollectionListResponse, type CollectionSectionListResponse, CollectionSectionsResource, type CollectionSummary, CollectionsResource, type CommentAnchor, type CommentAnchorInput, type CommentAnchorKind, type CommentDomAnchor, type CommentDraftAnswer, type CommentFieldAnchorInput, type CommentListOptions, type CommentListResponse, type CommentPersonRef, type CommentProposedValue, type CommentProposedValueInput, type CommentRecord, type CommentRect, type CommentReplyAnswer, type CommentResolution, type CommentSource, type CommentSpotAnchor, type CommentStatus, type CommentTarget, type CommentThread, type CommentThreadAnswer, type CommentVersionRef, type CommentViewport, CommentsResource, type CommonRequestOptions, type ConfirmUploadInput, type CreateCollectionInput, type CreateCommentInput, type CreateDocumentFieldInput, type CreateDocumentInput, type CreateDraftInput, type CreateFieldInput, type CreateItemInput, type CreateSectionInput, type CreateUploadUrlInput, type CurrencyValue, type DeleteDocumentOptions, type DeleteItemOptions, type DeleteOptions, type DeliveryStatus, type DocumentDeleteResponse, type DocumentDetail, type DocumentFieldListResponse, DocumentFieldsResource, type DocumentGetOptions, type DocumentListEntry, type DocumentListOptions, type DocumentListResponse, type DocumentMeta, type DocumentMutationResponse, type DocumentSectionListResponse, DocumentSectionsResource, type DocumentSeo, DocumentSeoResource, type DocumentSeoResponse, DocumentValuesResource, type DocumentValuesResponse, type DocumentVersionDetail, type DocumentVersionSeo, type DocumentVersionSummary, type DocumentVersionValue, DocumentVersionsResource, DocumentsResource, EelZapClient, EelZapError, type EelZapErrorCode, EelZapNetworkError, type EnumValue, type FieldConstraints, type FieldInfo, type FieldOptionInput, type FieldType, type FilterOperatorMap, type FilterValue, type GalleryItemValue, type IdempotencyOptions, type ItemDeleteResponse, type ItemDetail, type ItemFilters, type ItemGetOptions, type ItemListOptions, type ItemListResponse, type ItemMeta, type ItemMutationResponse, ItemQueryBuilder, type ItemSeo, ItemSeoResource, type ItemSeoResponse, type ItemVersionDetail, type ItemVersionSeo, type ItemVersionSlug, type ItemVersionSummary, type ItemVersionValue, ItemVersionsResource, ItemsResource, type JsonObject, type MediaAccess, type MediaDetail, type MediaDetailResponse, type MediaFromUrlInput, type MediaListParams, type MediaListResponse, MediaResource, type MediaSort, type MediaType, type MediaUploadInput, type MediaUsage, type MediaValue, MemoryCacheAdapter, type OnPageComment, type OnPageCommentAnchor, type OnPageComments, type OnPageField, type Pagination, type PreviewOption, type PreviewTokenValidation, PreviewTokensResource, type QueryPrimitive, type ReplyCommentInput, type RetryEvent, type RetryOptions, type SaveCommentToDraftInput, type SectionInfo, type SectionMeta, type Seo, type SeoImage, type SeoInput, type SiteInfo, type SiteListEntry, SiteResource, SitesResource, type ThreadComment, type UpdateCollectionInput, type UpdateCommentInput, type UpdateDocumentDraftInput, type UpdateDocumentFieldInput, type UpdateDocumentInput, type UpdateFieldInput, type UpdateItemDraftInput, type UpdateItemInput, type UpdateMediaInput, type UpdateSectionInput, type UpdateSiteInput, type UploadFile, type UploadUrlResponse, type VerifyWebhookOptions, type VersionDetail, type VersionGalleryItem, type VersionListResponse, type VersionSeo, type VersionStatus, type VersionSummary, type VersionValue, WEBHOOK_SIGNATURE_HEADER, WEBHOOK_TIMESTAMP_HEADER, WEBHOOK_TOLERANCE_SECONDS, type WebhookAction, type WebhookActor, type WebhookChange, type WebhookCollectionEventData, type WebhookCollectionRef, type WebhookCommentCreatedData, type WebhookCommentData, type WebhookCommentRef, type WebhookCommentReopenedData, type WebhookCommentRepliedData, type WebhookCommentResolvedData, type WebhookCommentSource, type WebhookCommentTarget, type WebhookCommentUpdatedData, type WebhookDocumentEventData, type WebhookEventName, type WebhookEventType, type WebhookHeaders, type WebhookItemEventData, type WebhookMediaEventData, type WebhookPayload, type WebhookSchemaEventData, type WebhookSeoEventData, type WebhookSiteEventData, type WebhookSiteRef, type WebhookSubject, cachedFetch, cleanStega, createClient, getMediaUrl, hasStega, isEelZapError, verifyWebhookSignature, webhookChanges };
+export { type ApiErrorDetail, type ApiErrorPayload, type CacheAdapter, type CacheStrategy, type CachedFetchOptions, type ClientConfig, type ClientDefaults, type CollectionDetail, type CollectionFieldListResponse, CollectionFieldsResource, type CollectionListResponse, type CollectionSectionListResponse, CollectionSectionsResource, type CollectionSummary, CollectionsResource, type CommentAnchor, type CommentAnchorInput, type CommentAnchorKind, type CommentDomAnchor, type CommentDraftAnswer, type CommentFieldAnchorInput, type CommentListOptions, type CommentListResponse, type CommentPersonRef, type CommentProposedValue, type CommentProposedValueInput, type CommentRecord, type CommentRect, type CommentReplyAnswer, type CommentResolution, type CommentSource, type CommentSpotAnchor, type CommentStatus, type CommentTarget, type CommentThread, type CommentThreadAnswer, type CommentVersionRef, type CommentViewport, CommentsResource, type CommonRequestOptions, type ConfirmUploadInput, type CreateCollectionInput, type CreateCommentInput, type CreateDocumentFieldInput, type CreateDocumentInput, type CreateDraftInput, type CreateFieldInput, type CreateItemInput, type CreateSectionInput, type CreateUploadUrlInput, type CurrencyValue, type DeleteDocumentOptions, type DeleteItemOptions, type DeleteOptions, type DeliveryStatus, type DocumentDeleteResponse, type DocumentDetail, type DocumentFieldListResponse, DocumentFieldsResource, type DocumentGetOptions, type DocumentListEntry, type DocumentListOptions, type DocumentListResponse, type DocumentMeta, type DocumentMutationResponse, type DocumentSectionListResponse, DocumentSectionsResource, type DocumentSeo, DocumentSeoResource, type DocumentSeoResponse, DocumentValuesResource, type DocumentValuesResponse, type DocumentVersionDetail, type DocumentVersionSeo, type DocumentVersionSummary, type DocumentVersionValue, DocumentVersionsResource, DocumentsResource, EelZapClient, EelZapError, type EelZapErrorCode, EelZapNetworkError, type EnumValue, type FieldConstraints, type FieldInfo, type FieldOptionInput, type FieldType, type FilterOperatorMap, type FilterValue, type GalleryItemValue, type IdempotencyOptions, type ItemDeleteResponse, type ItemDetail, type ItemFilters, type ItemGetOptions, type ItemListOptions, type ItemListResponse, type ItemMeta, type ItemMutationResponse, ItemQueryBuilder, type ItemSeo, ItemSeoResource, type ItemSeoResponse, type ItemVersionDetail, type ItemVersionSeo, type ItemVersionSlug, type ItemVersionSummary, type ItemVersionValue, ItemVersionsResource, ItemsResource, type JsonObject, type MediaAccess, type MediaDetail, type MediaDetailResponse, type MediaFromUrlInput, type MediaListParams, type MediaListResponse, MediaResource, type MediaSort, type MediaType, type MediaUploadInput, type MediaUsage, type MediaValue, MemoryCacheAdapter, type OnPageComment, type OnPageCommentAnchor, type OnPageComments, type OnPageField, type Pagination, type PreviewOption, type PreviewTokenValidation, PreviewTokensResource, type QueryPrimitive, type ReplyCommentInput, type RetryEvent, type RetryOptions, type SaveCommentToDraftInput, type SectionInfo, type SectionMeta, type Seo, type SeoImage, type SeoInput, type SiteInfo, type SiteListEntry, SiteResource, SitesResource, type ThreadComment, type UpdateCollectionInput, type UpdateCommentInput, type UpdateDocumentDraftInput, type UpdateDocumentFieldInput, type UpdateDocumentInput, type UpdateFieldInput, type UpdateItemDraftInput, type UpdateItemInput, type UpdateMediaInput, type UpdateSectionInput, type UpdateSiteInput, type UploadFile, type UploadUrlResponse, type VerifyWebhookOptions, type VersionActorKind, type VersionDetail, type VersionGalleryItem, type VersionListResponse, type VersionSeo, type VersionStatus, type VersionSummary, type VersionValue, WEBHOOK_SIGNATURE_HEADER, WEBHOOK_TIMESTAMP_HEADER, WEBHOOK_TOLERANCE_SECONDS, type WebhookAction, type WebhookActor, type WebhookChange, type WebhookCollectionEventData, type WebhookCollectionRef, type WebhookCommentCreatedData, type WebhookCommentData, type WebhookCommentRef, type WebhookCommentReopenedData, type WebhookCommentRepliedData, type WebhookCommentResolvedData, type WebhookCommentSource, type WebhookCommentTarget, type WebhookCommentUpdatedData, type WebhookDocumentEventData, type WebhookEventName, type WebhookEventType, type WebhookHeaders, type WebhookItemEventData, type WebhookMediaEventData, type WebhookPayload, type WebhookSchemaEventData, type WebhookSeoEventData, type WebhookSiteEventData, type WebhookSiteRef, type WebhookSubject, cachedFetch, cleanStega, createClient, getMediaUrl, hasStega, isEelZapError, verifyWebhookSignature, webhookChanges };

package/dist/preview.d.ts

@@ -104,11 +104,15 @@ declare function zapAttrs(entry: EntryLike, fieldKey: string): {
  * - Comparar (#953), two frames of one page side by side, the published one
  *   and the draft. Scroll sync, only to a page whose `zap:ready` advertised
  *   `scroll-sync`: `zap:scroll-sync` (editor → page) `{ enabled }` starts or
- *   stops `zap:scroll` (page → editor) `{ y, x?, anchor? }`, one per animation
- *   frame at most, positions as fractions (0..1) of the scrollable range and
- *   `anchor` the tagged field nearest the viewport's top; `zap:scroll-to`
- *   (editor → page, same shape) places the page there, by the anchor when
- *   the page has that field, else by the fraction, and is never echoed back.
+ *   stops `zap:scroll` (page → editor) `{ y, x?, anchor?, next?, progress? }`,
+ *   one per animation frame at most, positions as fractions (0..1) of the
+ *   scrollable range, `anchor` the last tagged field whose top is at or above
+ *   the viewport's top (else the first in view), and since 0.11.1 `next` the
+ *   tagged field below it and `progress` how far the viewport's top is from
+ *   one to the other; `zap:scroll-to` (editor → page, same shape) places the
+ *   page there: between the two fields when it has both, else by the anchor,
+ *   else by the fraction, at most once per frame, and is never echoed back.
+ *   `next` and `progress` are optional: a 0.11.0 page or editor ignores them.
  *   Diff marks, only to a page whose `zap:ready` advertised `diff-marks`:
  *   `zap:marks` (editor → page) `{ marks }`, every element of each field
  *   marked in its tone, removed (published) or added (draft); ≤ 200 marks,
@@ -143,7 +147,7 @@ declare const MAX_MARK_LABEL = 200;
 declare const MAX_ANCHOR_NTH = 5000;
 type OverlayMode = 'inspect' | 'select' | 'spot' | 'off';
 declare const OVERLAY_MODES: readonly OverlayMode[];
-type Capability = 'overlay' | 'values' | 'stega' | 'pins' | 'links' | 'refresh' | 'scroll-sync' | 'diff-marks' | 'fragment-token';
+type Capability = 'overlay' | 'values' | 'stega' | 'pins' | 'links' | 'refresh' | 'scroll-sync' | 'diff-marks' | 'fragment-token' | 'structured-values';
 declare const CAPABILITIES: readonly Capability[];
 
 /**
@@ -155,6 +159,12 @@ declare const CAPABILITIES: readonly Capability[];
  * should show. A bare string, number or boolean is shorthand for `{ text }`.
  * `{ url }` and `{ email }` (a URL and an EMAIL field, `links` capability) go
  * to a link's `href` rather than its text.
+ *
+ * With the `structured-values` capability, a CURRENCY field travels as
+ * {@link PreviewCurrencyValue} and an ENUM as {@link PreviewEnumValue}: the
+ * delivery API's own shapes, so a site's `price.amountMinor` and
+ * `category.value` survive a live merge (`useZapLiveUpdates`). The overlay
+ * writes their `text` / `label`.
  */
 type PreviewValue = string | number | boolean | null | {
     text: string;
@@ -170,7 +180,18 @@ type PreviewValue = string | number | boolean | null | {
         srcset?: string | null;
         alt?: string | null;
     };
-};
+} | PreviewCurrencyValue | PreviewEnumValue;
+/** A CURRENCY field: the stored minor units, the ISO 4217 code, and the formatted text to show. */
+interface PreviewCurrencyValue {
+    amountMinor: number;
+    currency: string;
+    text: string;
+}
+/** An ENUM field: the option's value and its label (what the page shows). */
+interface PreviewEnumValue {
+    value: string;
+    label: string;
+}
 /** Longest EMAIL value accepted (RFC 5321's path limit). */
 declare const MAX_EMAIL_LENGTH = 320;
 /** How the page found an element: a stega marker in its text, or a `data-zap` attribute. */
@@ -319,27 +340,36 @@ interface PausedPayload {
     reason: 'runaway' | 'cap';
     count: number;
 }
-/**
- * A tagged field's element as a scroll anchor: the `nth` element of the field
- * (in `TagIndex.byField` order, 0 first) and its top's distance below the
- * viewport's top, CSS px (negative once it scrolled past).
- */
-interface ScrollAnchor {
+/** A tagged field's element: the `nth` element of the field (in `TagIndex.byField` order, 0 first). */
+interface ScrollFieldRef {
     recordRef: RecordRef;
     fieldKey: string;
     nth: number;
+}
+/**
+ * A tagged field's element as a scroll anchor, and its top's distance below
+ * the viewport's top, CSS px (negative once it scrolled past).
+ */
+interface ScrollAnchor extends ScrollFieldRef {
     offset: number;
 }
 /**
  * `zap:scroll` and `zap:scroll-to`: the scroll position as fractions (0..1) of
  * the scrollable range (`x` only when the page scrolls sideways), and the
- * field nearest the viewport's top, which aligns two pages of different
- * lengths better than the fraction does.
+ * fields around the viewport's top, which align two pages of different
+ * lengths better than the fraction does. With `next` and `progress` (0.11.1)
+ * the other page puts its top that far between ITS two fields, so the
+ * position stays continuous when the anchor moves on to the next field, even
+ * where the two pages space their fields differently.
  */
 interface ScrollPayload {
     y: number;
     x?: number;
     anchor?: ScrollAnchor;
+    /** The tagged field below the anchor. */
+    next?: ScrollFieldRef;
+    /** 0 with the anchor at the viewport's top, 1 with `next` there. */
+    progress?: number;
 }
 /**
  * One Comparar mark (`zap:marks`): every element of the field gets a box in
@@ -471,7 +501,7 @@ declare function parseEditorMessage(data: unknown): ParseResult<EditorMessage>;
 declare function parsePageMessage(data: unknown): ParseResult<PageMessage>;
 declare function envelope<T extends string, P>(type: T, session: string, payload: P): Envelope<T, P>;
 
-declare const TAG_SELECTOR = "[data-zap],[data-zap-field]";
+declare const TAG_SELECTOR = "[data-zap],[data-zap-field],[data-zap-site-renders]";
 interface TaggedElement {
     element: Element;
     recordRef: RecordRef;
@@ -482,11 +512,13 @@ interface TaggedElement {
     html: boolean;
     /** `attr` for a manual tag, `stega` for a marker found in a text node. */
     source: TagSource;
+    /** `data-zap-site-renders`: the site renders this field here; never written into. */
+    siteRenders?: true;
     /** Stega only: the text node that carries the marker (values are written to it). */
     textNode?: Text;
 }
 interface TagProblem {
-    attribute: 'data-zap' | 'data-zap-field' | 'data-zap-entry';
+    attribute: 'data-zap' | 'data-zap-field' | 'data-zap-entry' | 'data-zap-site-renders';
     value: string;
 }
 type ReadTagResult = {
@@ -756,7 +788,7 @@ declare function createPageBridge(options: PageBridgeOptions): PageBridge;
  * Live client (`live.ts`) boots it inside the customer's own page, framed by
  * Zap's editor by its real URL (§2.7).
  */
-declare const CLIENT_VERSION = "0.11.0";
+declare const CLIENT_VERSION = "0.11.1";
 interface RuntimeOptions {
     win?: Window;
     doc?: Document;
@@ -871,7 +903,9 @@ type ValuesHandler = (patch: Record<string, PreviewValue>, payload: ValuesPayloa
 /**
  * Call `handler` with each `zap:values` patch for `entry` (unsaved keystrokes
  * from the editor), for sites that compute things from values. The tagged
- * elements are updated anyway; this is for everything else. Values arrive
+ * elements are updated anyway, except those marked `data-zap-site-renders`
+ * (`fields(…).derived(key)`), which the site renders from this patch; this is
+ * for everything else. Values arrive
  * formatted for display, exactly as the overlay writes them. Returns an
  * unsubscribe function. Works before or after `initZap`.
  */
@@ -1053,4 +1087,4 @@ declare function buildAnchor(element: Element, index: TagIndex, pageUrl: string,
  */
 declare function findAnchorElement(anchor: DomAnchor, index: TagIndex, doc: Document, win: Window): Element | null;
 
-export { CAPABILITIES, CLIENT_VERSION, type Capability, type ClickPayload, type DiffMark, type DomAnchor, type DropReason, type DropStats, EDITOR_MESSAGE_TYPES, type EditorMessage, type EditorMessageType, type EditorMessages, type EntryLike, type Envelope, FIELD_KEY_RE, type FieldRefPayload, type HelloPayload, type InitZapOptions, MAX_ANCHORS, MAX_ANCHOR_NTH, MAX_DRAFT_ROUTE_LENGTH, MAX_EMAIL_LENGTH, MAX_LABELS, MAX_MARKS, MAX_MARK_LABEL, MAX_MESSAGE_BYTES, MAX_PINS, MAX_QUOTE_CONTEXT, MAX_QUOTE_EXACT, MAX_SELECTOR_BYTES, MAX_TAG_REPORT, MAX_URL_LENGTH, type MessageTargetLike, type NormalizedRect, OVERLAY_HOST_TAG, OVERLAY_MODES, type ObserveOptions, Overlay, type OverlayCallbacks, type OverlayMode, type OverlayOptions, type OverlayTheme, PAGE_MESSAGE_TYPES, PAGE_UNLOAD_ERROR, PREVIEW_TOKEN_RE, PREVIEW_TOKEN_STORAGE_KEY, PROTOCOL_SOURCE, PROTOCOL_VERSION, type PageAnchor, type PageBridge, type PageBridgeOptions, type PageMessage, type PageMessageType, type PageMessages, type PageRuntime, type ParseResult, type ParsedRecordRef, type PausedPayload, type Pin, type PreviewValue, RICH_TEXT_ALLOWED_ATTRS, RICH_TEXT_ALLOWED_TAGS, RICH_TEXT_DROPPED_TAGS, type ReadTagResult, type ReadyPayload, type RecordRef, type RuntimeConfig, type RuntimeOptions, type ScrollAnchor, type ScrollPayload, type SpotAnchor, type SpotPayload, type SpotPoint, TAG_SELECTOR, TagIndex, type TagProblem, type TagSource, type TagSummary, type TaggedElement, type TextQuote, ValueApplier, type ValuesHandler, type ValuesPayload, ZAP_PREVIEW_TOKEN_HEADER, ZAP_PRODUCTION_ORIGIN, type ZapLive, buildAnchor, buildDomAnchor, buildSelector, cleanStega, createPageBridge, cssEscape, developmentZapOrigin, emptyDropStats, envelope, findAnchorElement, getPreviewToken, initZap, isDiffMark, isDomAnchor, isDraftRoutePath, isFieldKey, isLocale, isPageAnchor, isPin, isPinId, isPreviewTokenShape, isPreviewValue, isRecordRef, isSafeImageUrl, isSafeSrcset, isSafeUrl, isSession, messageBytes, normalizeText, normalizedRect, observeTags, onValues, parseEditorMessage, parsePageMessage, parseRecordRef, parseTag, previewHeaders, readElementTag, recordRefsOf, richTextToText, safeQueryAll, sanitizeRichText, sanitizeRichTextToString, startRuntime, textQuoteFor, utf8Length, zapAttrs };
+export { CAPABILITIES, CLIENT_VERSION, type Capability, type ClickPayload, type DiffMark, type DomAnchor, type DropReason, type DropStats, EDITOR_MESSAGE_TYPES, type EditorMessage, type EditorMessageType, type EditorMessages, type EntryLike, type Envelope, FIELD_KEY_RE, type FieldRefPayload, type HelloPayload, type InitZapOptions, MAX_ANCHORS, MAX_ANCHOR_NTH, MAX_DRAFT_ROUTE_LENGTH, MAX_EMAIL_LENGTH, MAX_LABELS, MAX_MARKS, MAX_MARK_LABEL, MAX_MESSAGE_BYTES, MAX_PINS, MAX_QUOTE_CONTEXT, MAX_QUOTE_EXACT, MAX_SELECTOR_BYTES, MAX_TAG_REPORT, MAX_URL_LENGTH, type MessageTargetLike, type NormalizedRect, OVERLAY_HOST_TAG, OVERLAY_MODES, type ObserveOptions, Overlay, type OverlayCallbacks, type OverlayMode, type OverlayOptions, type OverlayTheme, PAGE_MESSAGE_TYPES, PAGE_UNLOAD_ERROR, PREVIEW_TOKEN_RE, PREVIEW_TOKEN_STORAGE_KEY, PROTOCOL_SOURCE, PROTOCOL_VERSION, type PageAnchor, type PageBridge, type PageBridgeOptions, type PageMessage, type PageMessageType, type PageMessages, type PageRuntime, type ParseResult, type ParsedRecordRef, type PausedPayload, type Pin, type PreviewCurrencyValue, type PreviewEnumValue, type PreviewValue, RICH_TEXT_ALLOWED_ATTRS, RICH_TEXT_ALLOWED_TAGS, RICH_TEXT_DROPPED_TAGS, type ReadTagResult, type ReadyPayload, type RecordRef, type RuntimeConfig, type RuntimeOptions, type ScrollAnchor, type ScrollFieldRef, type ScrollPayload, type SpotAnchor, type SpotPayload, type SpotPoint, TAG_SELECTOR, TagIndex, type TagProblem, type TagSource, type TagSummary, type TaggedElement, type TextQuote, ValueApplier, type ValuesHandler, type ValuesPayload, ZAP_PREVIEW_TOKEN_HEADER, ZAP_PRODUCTION_ORIGIN, type ZapLive, buildAnchor, buildDomAnchor, buildSelector, cleanStega, createPageBridge, cssEscape, developmentZapOrigin, emptyDropStats, envelope, findAnchorElement, getPreviewToken, initZap, isDiffMark, isDomAnchor, isDraftRoutePath, isFieldKey, isLocale, isPageAnchor, isPin, isPinId, isPreviewTokenShape, isPreviewValue, isRecordRef, isSafeImageUrl, isSafeSrcset, isSafeUrl, isSession, messageBytes, normalizeText, normalizedRect, observeTags, onValues, parseEditorMessage, parsePageMessage, parseRecordRef, parseTag, previewHeaders, readElementTag, recordRefsOf, richTextToText, safeQueryAll, sanitizeRichText, sanitizeRichTextToString, startRuntime, textQuoteFor, utf8Length, zapAttrs };

package/dist/preview.js

@@ -64,7 +64,7 @@ import {
   textQuoteFor,
   utf8Length,
   zapAttrs
-} from "./chunk-72YCJCBI.js";
+} from "./chunk-G2JAAZKS.js";
 import {
   NEST_PRODUCTION_ORIGIN,
   PENDING_STORAGE_KEY,
@@ -81,7 +81,7 @@ var isLocalHost = (hostname) => LOCAL_ORIGIN.test(`http://${hostname}`);
 
 // src/preview/site/load.ts
 function loadChunk(name, _base) {
-  return name === "signin" ? import("./signin-XOGBCGBL.js") : import("./suggest-ERMR7PCE.js");
+  return name === "signin" ? import("./signin-XOGBCGBL.js") : import("./suggest-FDD4MBRP.js");
 }
 
 // src/preview/site/boot.ts
@@ -224,23 +224,17 @@ function createScrollSync(win, doc, index, post) {
   let frame = null;
   let last = "";
   let placed = null;
+  let target = null;
   const at = () => `${Math.round(win.scrollX)},${Math.round(win.scrollY)}`;
   const range = (size, view) => Math.max(0, size - view);
-  function anchor() {
-    let best = null;
-    let top = Infinity;
-    for (const tagged of index.elements) {
-      const rect = tagged.element.getBoundingClientRect();
-      if (rect.height <= 0 || rect.bottom <= 0 || rect.top >= win.innerHeight) continue;
-      if (Math.abs(rect.top) < Math.abs(top)) {
-        best = tagged;
-        top = rect.top;
-      }
-    }
-    if (!best) return void 0;
-    const { recordRef, fieldKey } = best;
-    const nth = index.byField(recordRef, fieldKey).indexOf(best);
-    return nth < 0 ? void 0 : { recordRef, fieldKey, nth, offset: Math.round(top) };
+  const nextFrame = (fn) => typeof win.requestAnimationFrame === "function" ? win.requestAnimationFrame(fn) : win.setTimeout(fn, 16);
+  function fieldRef(tagged) {
+    const { recordRef, fieldKey } = tagged;
+    return { recordRef, fieldKey, nth: index.byField(recordRef, fieldKey).indexOf(tagged) };
+  }
+  function topOf(ref) {
+    const element = ref && index.byField(ref.recordRef, ref.fieldKey)[ref.nth]?.element;
+    return element?.isConnected ? element.getBoundingClientRect().top : void 0;
   }
   function measure() {
     const root = doc.documentElement;
@@ -252,8 +246,31 @@ function createScrollSync(win, doc, index, post) {
     if (range(root.scrollWidth, win.innerWidth) > 0) {
       payload.x = fraction(win.scrollX, root.scrollWidth, win.innerWidth);
     }
-    const found = anchor();
-    if (found) payload.anchor = found;
+    let above = null;
+    let below = null;
+    let up = -Infinity;
+    let down = Infinity;
+    for (const tagged of index.elements) {
+      const { top, height } = tagged.element.getBoundingClientRect();
+      if (height <= 0) continue;
+      if (top > 0) {
+        if (top < down) {
+          below = tagged;
+          down = top;
+        }
+      } else if (top > up) {
+        above = tagged;
+        up = top;
+      }
+    }
+    const anchor = above ?? (down < win.innerHeight ? below : null);
+    if (anchor) {
+      payload.anchor = { ...fieldRef(anchor), offset: Math.round(above ? up : down) };
+      if (above && below) {
+        payload.next = fieldRef(below);
+        payload.progress = round(-up / (down - up));
+      }
+    }
     return payload;
   }
   function flush() {
@@ -267,9 +284,30 @@ function createScrollSync(win, doc, index, post) {
     last = key;
     post(payload);
   }
+  function apply() {
+    const next = target;
+    target = null;
+    if (!next) return;
+    const root = doc.documentElement;
+    const { y, x, anchor, progress } = next;
+    let top = y * range(root.scrollHeight, win.innerHeight);
+    const from = topOf(anchor);
+    const to = topOf(next.next);
+    if (from !== void 0) {
+      top = win.scrollY + from + (to !== void 0 && progress !== void 0 ? progress * (to - from) : -anchor.offset);
+    }
+    const left = x === void 0 ? win.scrollX : x * range(root.scrollWidth, win.innerWidth);
+    try {
+      win.scrollTo({ top, left, behavior: "instant" });
+    } catch {
+      win.scrollTo(left, top);
+    }
+    placed = at();
+    last = JSON.stringify(measure());
+  }
   const onScroll = () => {
     if (!enabled || frame !== null) return;
-    frame = typeof win.requestAnimationFrame === "function" ? win.requestAnimationFrame(flush) : win.setTimeout(flush, 16);
+    frame = nextFrame(flush);
   };
   return {
     setEnabled(next) {
@@ -282,24 +320,13 @@ function createScrollSync(win, doc, index, post) {
         flush();
       } else win.removeEventListener("scroll", onScroll);
     },
-    scrollTo({ y, x, anchor: target }) {
-      const root = doc.documentElement;
-      let top = y * range(root.scrollHeight, win.innerHeight);
-      const element = target && index.byField(target.recordRef, target.fieldKey)[target.nth]?.element;
-      if (element?.isConnected) {
-        top = win.scrollY + element.getBoundingClientRect().top - target.offset;
-      }
-      const left = x === void 0 ? win.scrollX : x * range(root.scrollWidth, win.innerWidth);
-      try {
-        win.scrollTo({ top, left, behavior: "instant" });
-      } catch {
-        win.scrollTo(left, top);
-      }
-      placed = at();
-      last = JSON.stringify(measure());
+    scrollTo(next) {
+      if (!target) nextFrame(apply);
+      target = next;
     },
     destroy() {
       enabled = false;
+      target = null;
       win.removeEventListener("scroll", onScroll);
     }
   };
@@ -475,6 +502,7 @@ var ValueApplier = class {
   }
   write(tagged, locale, value) {
     if (tagged.locale && tagged.locale !== locale) return false;
+    if (tagged.siteRenders) return false;
     const element = tagged.element;
     if (tagged.textNode) {
       const text2 = plainText(value);
@@ -511,7 +539,7 @@ var ValueApplier = class {
 function plainText(value) {
   if (value === null || typeof value !== "object") return value === null ? "" : String(value);
   const v = value;
-  return v.text ?? v.url ?? v.email ?? null;
+  return v.text ?? v.label ?? v.url ?? v.email ?? null;
 }
 function writeLink(element, value, base) {
   const email = "email" in value;
@@ -564,7 +592,7 @@ function writeImage(element, image, base) {
 }
 
 // src/preview/runtime.ts
-var CLIENT_VERSION = "0.11.0";
+var CLIENT_VERSION = "0.11.1";
 var MAX_PROBLEM_REPORTS = 20;
 function startRuntime(config, options = {}) {
   const win = options.win ?? window;