@bettercms-ai/sdk 1.27.0 → 1.29.0

package/dist/index.d.cts

@@ -527,7 +527,7 @@ declare class BetterCMSError extends Error {
  * every published site while the builder happily offers it. `radio`/`checkboxes`
  * were exactly that gap.
  */
-type DeliveryFormFieldType = "text" | "email" | "phone" | "url" | "number" | "date" | "textarea" | "select" | "radio" | "checkboxes" | "checkbox" | "consent" | "hidden";
+type DeliveryFormFieldType = "text" | "email" | "phone" | "url" | "number" | "date" | "textarea" | "select" | "radio" | "checkboxes" | "checkbox" | "consent" | "hidden" | "step";
 interface DeliveryFormField {
     key: string;
     label: string;
@@ -792,6 +792,8 @@ interface ManagedComponentInput {
      * variant family, which is started from it when it has none.
      */
     variantOf?: string;
+    /** Create only: a built-in section id (`builtin:<key>`) to copy in; the fields you send win. */
+    from?: string;
     /** Update only: prop chrome by prop path (`cta.label`). Any of these, or `override`, needs `ifMatch`. */
     propUi?: Record<string, Record<string, unknown> | null>;
     propGroup?: Record<string, Record<string, unknown> | null>;
@@ -1242,6 +1244,8 @@ interface StegaPayload {
     slug: string;
     /** Field key (or block id) the value belongs to. */
     field: string;
+    /** The binding kind (`text`), where the encoder knows it. */
+    kind?: string;
 }
 /** Append an invisible provenance payload to a string. */
 declare function encodeStega(clean: string, payload: StegaPayload): string;
@@ -1252,6 +1256,72 @@ declare function decodeStega(value: string): {
 } | null;
 /** Remove any stega payload, returning the clean string. */
 declare function stripStega(value: string): string;
+/**
+ * Where a value BEGINS in a rendered page: an empty frame. The canvas brackets every bound
+ * string with it and the payload frame, so a text node can be told inside a value from text
+ * that merely precedes one. @see resolveStega
+ */
+declare const STEGA_OPEN = "\u2060\u2061";
+/** Remove EVERY stega frame, markers included. What a value passes through before it is saved or published. */
+declare function stegaClean(value: string): string;
+/** The least of a DOM node this needs: a real `Node` satisfies it, and so does a test's plain object. */
+interface StegaNode {
+    textContent: string | null;
+    parentNode: StegaNode | null;
+    childNodes?: ArrayLike<StegaNode>;
+}
+/**
+ * Which value does this node render? Its payload and the nearest ancestor that holds the whole
+ * value, or null when the node's text belongs to none.
+ *
+ * By CONTENT, not by attribute: a splitting library cuts a heading into one element per
+ * character, a marquee clones its track, a component redraws its children, and the element a
+ * build stamped is gone or copied. The string survives all of that, in order, across however
+ * many text nodes: climbing from the clicked node, the first ancestor whose text holds a value
+ * (its open marker to its payload frame) that overlaps the node is the value's extent.
+ * Every copy of a value resolves to the same payload.
+ */
+declare function resolveStega(node: StegaNode): {
+    payload: StegaPayload;
+    element: StegaNode;
+} | null;
+
+/**
+ * `bcms:content-applied` — what the visual editor tells a page after it has applied an edit to
+ * the page's DOM.
+ *
+ * An edit changes how tall a heading is. Everything on the page that measured the layout once
+ * (ScrollTrigger's start and end positions, Lenis's scroll limit, a carousel's slide widths, a
+ * text splitter's lines) is now wrong, and only the page's own code can measure again. So the
+ * editor posts one message to the frame's window after each applied edit, and the site listens:
+ *
+ *   onContentApplied(() => ScrollTrigger.refresh());
+ *
+ * A published page receives no such message: nothing there posts it, and the listener is inert.
+ */
+/** The `type` of the message. */
+declare const CONTENT_APPLIED = "bcms:content-applied";
+interface ContentAppliedMessage {
+    type: typeof CONTENT_APPLIED;
+    /** The field addresses whose rendering changed; empty when the editor does not say. */
+    fields: string[];
+}
+/** The message the editor posts: `frame.contentWindow.postMessage(contentApplied(fields), origin)`. */
+declare const contentApplied: (fields?: readonly string[]) => ContentAppliedMessage;
+/** The least of `window` this needs. */
+interface MessageTarget {
+    addEventListener(type: "message", listener: (event: {
+        data: unknown;
+    }) => void): void;
+    removeEventListener(type: "message", listener: (event: {
+        data: unknown;
+    }) => void): void;
+}
+/**
+ * Run `handler` after every edit the editor applies to this page. Returns the function that
+ * stops listening. Safe to call where there is no window (a server render): it does nothing.
+ */
+declare function onContentApplied(handler: (message: ContentAppliedMessage) => void, target?: MessageTarget | undefined): () => void;
 
 /**
  * Reading a rich-text field, for any site.
@@ -1825,4 +1895,4 @@ interface WebhookListResponse {
     };
 }
 
-export { type AddPageFieldsInput, type ApiKeyUsage, type ApiKeyWithRaw, type AuthResult, BetterCMSError as BCMSClientError, ErrorCodes as BCMSErrorCodes, BetterCMS, BetterCMSAdminClient, type BetterCMSAdminOptions, BetterCMSDeliveryClient, BetterCMSError, BetterCMSManagementClient, type BetterCMSManagementOptions, type BetterCMSReadClient, type BetterCMSSiteOptions, type CommandManagedLayoutInput, type CreateApiKeyInput, type CreateClientOptions, type CreateEntryInput, type CreateFormInput, type CreateManagedPageInput, type CreateModelInput, type CreatePageInput, type CreateWebhookInput, type CreateWorkspaceInput, type DeliveryForm, type DeliveryFormField, type DeliveryFormFieldType, ErrorCodes, type ExtractionCandidate, type FormFieldInput, type FormListOptions, type FormSubmitError, type FormValue, type FormValues, type GetEntryOptions, type GetManagedLayoutOptions, type ListContentAllOptions, type ListContentOptions, type ListEntriesFilter, type ListEntriesOptions, type ListPagesOptions, type ManagedComponent, type ManagedComponentInput, type ManagedComponentSummary, type ManagedContentEntry, type ManagedContentModel, type ManagedForm, type ManagedFormInput, type ManagedLayoutClient, type ManagedLayoutDocument, type ManagedMediaAsset, type ManagedPage, type ManagementClient, type MediaListOptions, type MediaMetadata, type Member, type MemberRole, type ModelFieldset, PORTABLE_TEXT_FORMAT, type PageCreateReport, type PageListOptions, type PendingInvite, type PublishManagedLayoutInput, type PublishedContent, type ResolvedSeo, type RichTextValue, type SearchHit, type SearchOptions, type SeoInput, type SeoLocation, type SeoMeta, type SeoMetaInput, type SetPageContentInput, type StegaPayload, type SubmissionListOptions, type SubmitFormOptions, type SubmitFormResult, type TextOrRich, type UpdateApiKeyInput, type UpdateAssetInput, type UpdateEntryInput, type UpdateFormInput, type UpdateModelInput, type UpdatePageInput, type UpdateWebhookInput, type UpdateWorkspaceInput, type UploadAssetInput, type UploadedAsset, type Webhook, type WebhookAdvancedConfig, type WebhookEvent, type WebhookListResponse, type WebhookWithSecret, type WriteContentInput, addModelFields, addPageFields, asStringArray, commandManagedLayout, createApiKey, createClient, createEntry, createForm, createManagedPage, createModel, createPage, createWorkspace, decodeStega, deleteForm, deleteMedia, deletePage, deleteSubmission, deleteWorkspace, encodeStega, entrySeoInput, formInitialValues, getApiKeyUsage, getEntry, getForm, getManagedLayout, getManagedPage, getMedia, getMember, getModel, getPage, getSubmission, getWorkspace, inviteMember, isMultiValueField, isRichText, listApiKeys, listEntries, listForms, listManagedPages, listMedia, listMembers, listModels, listPages, listSubmissions, listWorkspaces, plain, portableText, publishManagedLayout, publishPage, publishedContentFile, publishedEntry, readPublishedContent, regenerateApiKey, removeMember, resetPublishedContentCache, resolveSeo, revokeApiKey, rich, search, setPageContent, shouldShowField, signIn, signInWithGithub, signInWithGoogle, signUp, stripStega, submitForm, toggleOption, updateApiKey, updateEntry, updateForm, updateMemberRole, updateModel, updatePage, updatePageModel, updateWorkspace, uploadMedia };
+export { type AddPageFieldsInput, type ApiKeyUsage, type ApiKeyWithRaw, type AuthResult, BetterCMSError as BCMSClientError, ErrorCodes as BCMSErrorCodes, BetterCMS, BetterCMSAdminClient, type BetterCMSAdminOptions, BetterCMSDeliveryClient, BetterCMSError, BetterCMSManagementClient, type BetterCMSManagementOptions, type BetterCMSReadClient, type BetterCMSSiteOptions, CONTENT_APPLIED, type CommandManagedLayoutInput, type ContentAppliedMessage, type CreateApiKeyInput, type CreateClientOptions, type CreateEntryInput, type CreateFormInput, type CreateManagedPageInput, type CreateModelInput, type CreatePageInput, type CreateWebhookInput, type CreateWorkspaceInput, type DeliveryForm, type DeliveryFormField, type DeliveryFormFieldType, ErrorCodes, type ExtractionCandidate, type FormFieldInput, type FormListOptions, type FormSubmitError, type FormValue, type FormValues, type GetEntryOptions, type GetManagedLayoutOptions, type ListContentAllOptions, type ListContentOptions, type ListEntriesFilter, type ListEntriesOptions, type ListPagesOptions, type ManagedComponent, type ManagedComponentInput, type ManagedComponentSummary, type ManagedContentEntry, type ManagedContentModel, type ManagedForm, type ManagedFormInput, type ManagedLayoutClient, type ManagedLayoutDocument, type ManagedMediaAsset, type ManagedPage, type ManagementClient, type MediaListOptions, type MediaMetadata, type Member, type MemberRole, type ModelFieldset, PORTABLE_TEXT_FORMAT, type PageCreateReport, type PageListOptions, type PendingInvite, type PublishManagedLayoutInput, type PublishedContent, type ResolvedSeo, type RichTextValue, STEGA_OPEN, type SearchHit, type SearchOptions, type SeoInput, type SeoLocation, type SeoMeta, type SeoMetaInput, type SetPageContentInput, type StegaNode, type StegaPayload, type SubmissionListOptions, type SubmitFormOptions, type SubmitFormResult, type TextOrRich, type UpdateApiKeyInput, type UpdateAssetInput, type UpdateEntryInput, type UpdateFormInput, type UpdateModelInput, type UpdatePageInput, type UpdateWebhookInput, type UpdateWorkspaceInput, type UploadAssetInput, type UploadedAsset, type Webhook, type WebhookAdvancedConfig, type WebhookEvent, type WebhookListResponse, type WebhookWithSecret, type WriteContentInput, addModelFields, addPageFields, asStringArray, commandManagedLayout, contentApplied, createApiKey, createClient, createEntry, createForm, createManagedPage, createModel, createPage, createWorkspace, decodeStega, deleteForm, deleteMedia, deletePage, deleteSubmission, deleteWorkspace, encodeStega, entrySeoInput, formInitialValues, getApiKeyUsage, getEntry, getForm, getManagedLayout, getManagedPage, getMedia, getMember, getModel, getPage, getSubmission, getWorkspace, inviteMember, isMultiValueField, isRichText, listApiKeys, listEntries, listForms, listManagedPages, listMedia, listMembers, listModels, listPages, listSubmissions, listWorkspaces, onContentApplied, plain, portableText, publishManagedLayout, publishPage, publishedContentFile, publishedEntry, readPublishedContent, regenerateApiKey, removeMember, resetPublishedContentCache, resolveSeo, resolveStega, revokeApiKey, rich, search, setPageContent, shouldShowField, signIn, signInWithGithub, signInWithGoogle, signUp, stegaClean, stripStega, submitForm, toggleOption, updateApiKey, updateEntry, updateForm, updateMemberRole, updateModel, updatePage, updatePageModel, updateWorkspace, uploadMedia };

package/dist/index.d.ts

@@ -527,7 +527,7 @@ declare class BetterCMSError extends Error {
  * every published site while the builder happily offers it. `radio`/`checkboxes`
  * were exactly that gap.
  */
-type DeliveryFormFieldType = "text" | "email" | "phone" | "url" | "number" | "date" | "textarea" | "select" | "radio" | "checkboxes" | "checkbox" | "consent" | "hidden";
+type DeliveryFormFieldType = "text" | "email" | "phone" | "url" | "number" | "date" | "textarea" | "select" | "radio" | "checkboxes" | "checkbox" | "consent" | "hidden" | "step";
 interface DeliveryFormField {
     key: string;
     label: string;
@@ -792,6 +792,8 @@ interface ManagedComponentInput {
      * variant family, which is started from it when it has none.
      */
     variantOf?: string;
+    /** Create only: a built-in section id (`builtin:<key>`) to copy in; the fields you send win. */
+    from?: string;
     /** Update only: prop chrome by prop path (`cta.label`). Any of these, or `override`, needs `ifMatch`. */
     propUi?: Record<string, Record<string, unknown> | null>;
     propGroup?: Record<string, Record<string, unknown> | null>;
@@ -1242,6 +1244,8 @@ interface StegaPayload {
     slug: string;
     /** Field key (or block id) the value belongs to. */
     field: string;
+    /** The binding kind (`text`), where the encoder knows it. */
+    kind?: string;
 }
 /** Append an invisible provenance payload to a string. */
 declare function encodeStega(clean: string, payload: StegaPayload): string;
@@ -1252,6 +1256,72 @@ declare function decodeStega(value: string): {
 } | null;
 /** Remove any stega payload, returning the clean string. */
 declare function stripStega(value: string): string;
+/**
+ * Where a value BEGINS in a rendered page: an empty frame. The canvas brackets every bound
+ * string with it and the payload frame, so a text node can be told inside a value from text
+ * that merely precedes one. @see resolveStega
+ */
+declare const STEGA_OPEN = "\u2060\u2061";
+/** Remove EVERY stega frame, markers included. What a value passes through before it is saved or published. */
+declare function stegaClean(value: string): string;
+/** The least of a DOM node this needs: a real `Node` satisfies it, and so does a test's plain object. */
+interface StegaNode {
+    textContent: string | null;
+    parentNode: StegaNode | null;
+    childNodes?: ArrayLike<StegaNode>;
+}
+/**
+ * Which value does this node render? Its payload and the nearest ancestor that holds the whole
+ * value, or null when the node's text belongs to none.
+ *
+ * By CONTENT, not by attribute: a splitting library cuts a heading into one element per
+ * character, a marquee clones its track, a component redraws its children, and the element a
+ * build stamped is gone or copied. The string survives all of that, in order, across however
+ * many text nodes: climbing from the clicked node, the first ancestor whose text holds a value
+ * (its open marker to its payload frame) that overlaps the node is the value's extent.
+ * Every copy of a value resolves to the same payload.
+ */
+declare function resolveStega(node: StegaNode): {
+    payload: StegaPayload;
+    element: StegaNode;
+} | null;
+
+/**
+ * `bcms:content-applied` — what the visual editor tells a page after it has applied an edit to
+ * the page's DOM.
+ *
+ * An edit changes how tall a heading is. Everything on the page that measured the layout once
+ * (ScrollTrigger's start and end positions, Lenis's scroll limit, a carousel's slide widths, a
+ * text splitter's lines) is now wrong, and only the page's own code can measure again. So the
+ * editor posts one message to the frame's window after each applied edit, and the site listens:
+ *
+ *   onContentApplied(() => ScrollTrigger.refresh());
+ *
+ * A published page receives no such message: nothing there posts it, and the listener is inert.
+ */
+/** The `type` of the message. */
+declare const CONTENT_APPLIED = "bcms:content-applied";
+interface ContentAppliedMessage {
+    type: typeof CONTENT_APPLIED;
+    /** The field addresses whose rendering changed; empty when the editor does not say. */
+    fields: string[];
+}
+/** The message the editor posts: `frame.contentWindow.postMessage(contentApplied(fields), origin)`. */
+declare const contentApplied: (fields?: readonly string[]) => ContentAppliedMessage;
+/** The least of `window` this needs. */
+interface MessageTarget {
+    addEventListener(type: "message", listener: (event: {
+        data: unknown;
+    }) => void): void;
+    removeEventListener(type: "message", listener: (event: {
+        data: unknown;
+    }) => void): void;
+}
+/**
+ * Run `handler` after every edit the editor applies to this page. Returns the function that
+ * stops listening. Safe to call where there is no window (a server render): it does nothing.
+ */
+declare function onContentApplied(handler: (message: ContentAppliedMessage) => void, target?: MessageTarget | undefined): () => void;
 
 /**
  * Reading a rich-text field, for any site.
@@ -1825,4 +1895,4 @@ interface WebhookListResponse {
     };
 }
 
-export { type AddPageFieldsInput, type ApiKeyUsage, type ApiKeyWithRaw, type AuthResult, BetterCMSError as BCMSClientError, ErrorCodes as BCMSErrorCodes, BetterCMS, BetterCMSAdminClient, type BetterCMSAdminOptions, BetterCMSDeliveryClient, BetterCMSError, BetterCMSManagementClient, type BetterCMSManagementOptions, type BetterCMSReadClient, type BetterCMSSiteOptions, type CommandManagedLayoutInput, type CreateApiKeyInput, type CreateClientOptions, type CreateEntryInput, type CreateFormInput, type CreateManagedPageInput, type CreateModelInput, type CreatePageInput, type CreateWebhookInput, type CreateWorkspaceInput, type DeliveryForm, type DeliveryFormField, type DeliveryFormFieldType, ErrorCodes, type ExtractionCandidate, type FormFieldInput, type FormListOptions, type FormSubmitError, type FormValue, type FormValues, type GetEntryOptions, type GetManagedLayoutOptions, type ListContentAllOptions, type ListContentOptions, type ListEntriesFilter, type ListEntriesOptions, type ListPagesOptions, type ManagedComponent, type ManagedComponentInput, type ManagedComponentSummary, type ManagedContentEntry, type ManagedContentModel, type ManagedForm, type ManagedFormInput, type ManagedLayoutClient, type ManagedLayoutDocument, type ManagedMediaAsset, type ManagedPage, type ManagementClient, type MediaListOptions, type MediaMetadata, type Member, type MemberRole, type ModelFieldset, PORTABLE_TEXT_FORMAT, type PageCreateReport, type PageListOptions, type PendingInvite, type PublishManagedLayoutInput, type PublishedContent, type ResolvedSeo, type RichTextValue, type SearchHit, type SearchOptions, type SeoInput, type SeoLocation, type SeoMeta, type SeoMetaInput, type SetPageContentInput, type StegaPayload, type SubmissionListOptions, type SubmitFormOptions, type SubmitFormResult, type TextOrRich, type UpdateApiKeyInput, type UpdateAssetInput, type UpdateEntryInput, type UpdateFormInput, type UpdateModelInput, type UpdatePageInput, type UpdateWebhookInput, type UpdateWorkspaceInput, type UploadAssetInput, type UploadedAsset, type Webhook, type WebhookAdvancedConfig, type WebhookEvent, type WebhookListResponse, type WebhookWithSecret, type WriteContentInput, addModelFields, addPageFields, asStringArray, commandManagedLayout, createApiKey, createClient, createEntry, createForm, createManagedPage, createModel, createPage, createWorkspace, decodeStega, deleteForm, deleteMedia, deletePage, deleteSubmission, deleteWorkspace, encodeStega, entrySeoInput, formInitialValues, getApiKeyUsage, getEntry, getForm, getManagedLayout, getManagedPage, getMedia, getMember, getModel, getPage, getSubmission, getWorkspace, inviteMember, isMultiValueField, isRichText, listApiKeys, listEntries, listForms, listManagedPages, listMedia, listMembers, listModels, listPages, listSubmissions, listWorkspaces, plain, portableText, publishManagedLayout, publishPage, publishedContentFile, publishedEntry, readPublishedContent, regenerateApiKey, removeMember, resetPublishedContentCache, resolveSeo, revokeApiKey, rich, search, setPageContent, shouldShowField, signIn, signInWithGithub, signInWithGoogle, signUp, stripStega, submitForm, toggleOption, updateApiKey, updateEntry, updateForm, updateMemberRole, updateModel, updatePage, updatePageModel, updateWorkspace, uploadMedia };
+export { type AddPageFieldsInput, type ApiKeyUsage, type ApiKeyWithRaw, type AuthResult, BetterCMSError as BCMSClientError, ErrorCodes as BCMSErrorCodes, BetterCMS, BetterCMSAdminClient, type BetterCMSAdminOptions, BetterCMSDeliveryClient, BetterCMSError, BetterCMSManagementClient, type BetterCMSManagementOptions, type BetterCMSReadClient, type BetterCMSSiteOptions, CONTENT_APPLIED, type CommandManagedLayoutInput, type ContentAppliedMessage, type CreateApiKeyInput, type CreateClientOptions, type CreateEntryInput, type CreateFormInput, type CreateManagedPageInput, type CreateModelInput, type CreatePageInput, type CreateWebhookInput, type CreateWorkspaceInput, type DeliveryForm, type DeliveryFormField, type DeliveryFormFieldType, ErrorCodes, type ExtractionCandidate, type FormFieldInput, type FormListOptions, type FormSubmitError, type FormValue, type FormValues, type GetEntryOptions, type GetManagedLayoutOptions, type ListContentAllOptions, type ListContentOptions, type ListEntriesFilter, type ListEntriesOptions, type ListPagesOptions, type ManagedComponent, type ManagedComponentInput, type ManagedComponentSummary, type ManagedContentEntry, type ManagedContentModel, type ManagedForm, type ManagedFormInput, type ManagedLayoutClient, type ManagedLayoutDocument, type ManagedMediaAsset, type ManagedPage, type ManagementClient, type MediaListOptions, type MediaMetadata, type Member, type MemberRole, type ModelFieldset, PORTABLE_TEXT_FORMAT, type PageCreateReport, type PageListOptions, type PendingInvite, type PublishManagedLayoutInput, type PublishedContent, type ResolvedSeo, type RichTextValue, STEGA_OPEN, type SearchHit, type SearchOptions, type SeoInput, type SeoLocation, type SeoMeta, type SeoMetaInput, type SetPageContentInput, type StegaNode, type StegaPayload, type SubmissionListOptions, type SubmitFormOptions, type SubmitFormResult, type TextOrRich, type UpdateApiKeyInput, type UpdateAssetInput, type UpdateEntryInput, type UpdateFormInput, type UpdateModelInput, type UpdatePageInput, type UpdateWebhookInput, type UpdateWorkspaceInput, type UploadAssetInput, type UploadedAsset, type Webhook, type WebhookAdvancedConfig, type WebhookEvent, type WebhookListResponse, type WebhookWithSecret, type WriteContentInput, addModelFields, addPageFields, asStringArray, commandManagedLayout, contentApplied, createApiKey, createClient, createEntry, createForm, createManagedPage, createModel, createPage, createWorkspace, decodeStega, deleteForm, deleteMedia, deletePage, deleteSubmission, deleteWorkspace, encodeStega, entrySeoInput, formInitialValues, getApiKeyUsage, getEntry, getForm, getManagedLayout, getManagedPage, getMedia, getMember, getModel, getPage, getSubmission, getWorkspace, inviteMember, isMultiValueField, isRichText, listApiKeys, listEntries, listForms, listManagedPages, listMedia, listMembers, listModels, listPages, listSubmissions, listWorkspaces, onContentApplied, plain, portableText, publishManagedLayout, publishPage, publishedContentFile, publishedEntry, readPublishedContent, regenerateApiKey, removeMember, resetPublishedContentCache, resolveSeo, resolveStega, revokeApiKey, rich, search, setPageContent, shouldShowField, signIn, signInWithGithub, signInWithGoogle, signUp, stegaClean, stripStega, submitForm, toggleOption, updateApiKey, updateEntry, updateForm, updateMemberRole, updateModel, updatePage, updatePageModel, updateWorkspace, uploadMedia };

package/dist/index.js

@@ -1395,6 +1395,52 @@ function decodeStega(value) {
 function stripStega(value) {
   return value.replace(FRAME, "");
 }
+var STEGA_OPEN = `${START}${END}`;
+var FRAMES = new RegExp(`${START}([${ZERO}${ONE}]*)${END}`, "g");
+function stegaClean(value) {
+  return value.replace(FRAMES, "");
+}
+function resolveStega(node) {
+  let offset = 0;
+  const length = node.textContent?.length ?? 0;
+  for (let cur = node, up = node.parentNode; up; cur = up, up = up.parentNode) {
+    for (const sibling of Array.from(up.childNodes ?? [])) {
+      if (sibling === cur) break;
+      offset += sibling.textContent?.length ?? 0;
+    }
+    const text = up.textContent ?? "";
+    const opens = [];
+    for (const frame of text.matchAll(FRAMES)) {
+      if (!frame[1]) {
+        opens.push(frame.index);
+        continue;
+      }
+      const open = opens.pop();
+      if (frame.index + frame[0].length <= offset || open === void 0 || open >= offset + length) continue;
+      try {
+        return { payload: JSON.parse(fromBits(frame[1])), element: up };
+      } catch {
+        break;
+      }
+    }
+  }
+  return null;
+}
+
+// src/content-applied.ts
+var CONTENT_APPLIED = "bcms:content-applied";
+var contentApplied = (fields = []) => ({ type: CONTENT_APPLIED, fields: [...fields] });
+function onContentApplied(handler, target = globalThis.window) {
+  if (!target) return () => {
+  };
+  const listener = (event) => {
+    const data = event.data;
+    if (!data || typeof data !== "object" || data.type !== CONTENT_APPLIED) return;
+    handler({ type: CONTENT_APPLIED, fields: Array.isArray(data.fields) ? data.fields.filter((f) => typeof f === "string") : [] });
+  };
+  target.addEventListener("message", listener);
+  return () => target.removeEventListener("message", listener);
+}
 
 // src/richtext.ts
 var PORTABLE_TEXT_FORMAT = "portable-text-1";
@@ -1862,6 +1908,7 @@ function shouldShowField(field, values) {
 function formInitialValues(form, prefill = {}) {
   const values = {};
   for (const field of form.fields) {
+    if (field.type === "step") continue;
     if (field.type === "checkbox" || field.type === "consent") {
       values[field.key] = false;
     } else if (field.type === "checkboxes") {
@@ -1912,12 +1959,15 @@ export {
   BetterCMSDeliveryClient,
   BetterCMSError,
   BetterCMSManagementClient,
+  CONTENT_APPLIED,
   ErrorCodes,
   PORTABLE_TEXT_FORMAT,
+  STEGA_OPEN,
   addModelFields,
   addPageFields,
   asStringArray,
   commandManagedLayout,
+  contentApplied,
   createApiKey,
   createClient,
   createEntry,
@@ -1965,6 +2015,7 @@ export {
   listPages,
   listSubmissions,
   listWorkspaces,
+  onContentApplied,
   plain,
   portableText,
   publishManagedLayout,
@@ -1976,6 +2027,7 @@ export {
   removeMember,
   resetPublishedContentCache,
   resolveSeo,
+  resolveStega,
   revokeApiKey,
   rich,
   search,
@@ -1985,6 +2037,7 @@ export {
   signInWithGithub,
   signInWithGoogle,
   signUp,
+  stegaClean,
   stripStega,
   submitForm,
   toggleOption,