` to an R2-served document.\n- **``** — empty-slot fallback for\n preview / edit modes.\n- **`==highlighted== text`** — expand\n the inline marker syntax into React nodes.\n- **``** — render a rich-text field's\n pre-sanitized HTML; forwards unknown props to the wrapper ``.\n- **`createLink({ createLinkClickHandler, navigation? })`** — factory\n for a `` with smooth-scroll on hash and same-page hrefs.\n With next-intl's `navigation` (`createNavigation(routing)`) it is\n locale-aware; without it, it renders `next/link` and ignores the\n `locale` prop.\n\n### Helpers\n\n```ts\nimport {\n composeSlugResolvers,\n createLinkClickHandler,\n createLinkClickHandlerFactory,\n createLinkHref,\n mediaAlt,\n mediaTypeIs,\n processHtmlMarkers,\n processText,\n resolveFocalPoint,\n resolveLocalized,\n resolveMediaUrl,\n toCanonicalPathname,\n useIsClient,\n useVisibleLinks,\n type SlugResolver,\n} from \"@bynoon/sdk\";\n```\n\n- **`resolveLocalized(value, locale, defaultLocale?)`** — resolve a\n `Localized` to a concrete `T`; falls back to `defaultLocale`, then\n to the first entry; `undefined` for empty input.\n- **`resolveMediaUrl(media, { baseUrl? })`** — the serving URL for a\n `MediaData`, `?v=` included after a CMS replace; `null`\n when there is nothing to serve.\n- **`resolveFocalPoint(media)`** — CSS `object-position` from the\n stored focal point.\n- **`mediaTypeIs(media, kind)`** — narrow by `\"image\" | \"video\" |\n\"document\"`; `false` for `null`.\n- **`mediaAlt(media, locale?, defaultLocale?)`** — the per-locale alt,\n or `\"\"`.\n- **`processText` / `processHtmlMarkers`** — the marker expanders\n (`==highlight==`, `||no-wrap||`, `\\n`) for plain text and HTML.\n- **`createLinkHref({ localizedSlugFor? })`** — `(link, locale) =>\nstring` for a `LinkData`; page links resolve by path.\n- **`createLinkClickHandler` / `createLinkClickHandlerFactory`** —\n the smooth-scroll click handler, bare or pre-bound to a next-intl\n routing config.\n- **`toCanonicalPathname(pathname, routing, defaultLocale)`** — strip\n the locale prefix and reverse-translate via `routing.pathnames`.\n- **`composeSlugResolvers([...])`** — first non-undefined result wins.\n- **`useIsClient()`** — `true` after first client mount, for code that\n cannot run under SSR.\n- **`useVisibleLinks(links, pathname)`** — the subset of a link list\n that should render on the current page.\n\n### Server (`@bynoon/sdk/server`, RSC-only)\n\n```ts\nimport {\n HeadSnippets,\n getParams,\n getRenderContext,\n globalSeoMetadata,\n mergeMetadata,\n pageSeoMetadata,\n} from \"@bynoon/sdk/server\";\n```\n\n- **`getRenderContext()`** — the per-request context the customer\n image's auth gateway populates (`mode`, `locale`, `projectId`, and in\n preview/edit the draft coordinates). Throws in the browser.\n- **`HeadSnippets`** — renders the global and per-page head snippets\n as real React elements so ``/`` hoist into ``.\n- **`globalSeoMetadata` / `pageSeoMetadata` / `mergeMetadata`** — build\n a Next `Metadata` object from the SEO sidecars, code-owned values\n winning per leaf.\n\n### Zod primitives\n\n```ts\nimport {\n linkDataSchema,\n localizedStringSchema,\n mediaDataSchema,\n} from \"@bynoon/sdk\";\n```\n\nThe primitives the CMS contract is built on; use them inside your own\nsection / content-type schemas so shapes stay consistent.\n`mediaDataSchema` mirrors `MediaData` exactly.\n\n## Editor tier\n\n`` renders the same page three ways, switched by the server\nrender context:\n\n- **live** — normal traffic; sections render from the bundled\n `page.bynoon.json` snapshot. No CMS round-trip.\n- **preview** — the request carries a preview token; the SDK fetches\n the latest draft sidecar from the Staging API instead.\n- **edit** — preview plus the iframe runtime; sections hydrate\n client-side and patch in place over `postMessage`.\n\nCustomer pages stay mode-agnostic — they always write\n``.\n\n```tsx\nimport {\n Chrome,\n Entry,\n Sections,\n registerEditSections,\n registerSectionSchemas,\n registerSections,\n renderSection,\n type SectionComponent,\n} from \"@bynoon/sdk\";\n```\n\n- **``** — renders a page's section\n instances in order, each wrapped in ``;\n skips `hidden` instances in live mode.\n- **``** and **``** — the same for chrome singletons and content-type entries.\n- **`registerSections` / `registerSectionSchemas` /\n `registerEditSections`** — the generated `sections/registry.ts` calls\n these once; import it for its side effect in the root layout.\n- **`renderSection(section)`** — the imperative form.\n\n### Schema builders (`@bynoon/sdk/schemas`)\n\n```ts\nimport {\n iconValue,\n linkValue,\n localized,\n mediaDocument,\n mediaImage,\n mediaVisual,\n numberValue,\n referenceArrayValue,\n referenceValue,\n selectValue,\n} from \"@bynoon/sdk/schemas\";\n```\n\nA section's `schema.ts` composes these; pairing each field with a\n`FieldMeta` entry tells the editor's auto-form which input to render.\n\n### Editor runtime (`@bynoon/sdk/edit`)\n\n```ts\nimport { FieldOverlay, type EditorMessage } from \"@bynoon/sdk/edit\";\n```\n\n- **``** — optional marker in a section's\n `edit.tsx`; anchors the hover/click affordance in edit mode, no-ops\n otherwise.\n- **`EditorMessage`** — the typed `postMessage` contract between the\n `/editor` parent and the iframe runtime.\n\n## Types\n\n```ts\nimport type {\n ChromeSidecar,\n ClientRenderContext,\n ContentEntryRenderProps,\n EntrySidecar,\n FieldData,\n FieldMeta,\n FieldMetaType,\n LinkData,\n Localized,\n MediaData,\n MediaKind,\n PageOption,\n SdkContextValue,\n SdkMode,\n SectionInstance,\n SectionRenderProps,\n} from \"@bynoon/sdk\";\n```\n\n`MediaData` and `LinkData` mirror `@bynoon/contract`'s `MediaValue`\nand `LinkValue`; `FieldMeta` supersedes the legacy `FieldData`.\n\nDeprecated aliases, kept until every site's code has moved off them:\n`ImageData` (`MediaData`), `PageData` (`PageOption`), `imageDataSchema`\n(`mediaDataSchema`) and `getPages()` (always an empty list — page links\nresolve by path).\n","readmeFilename":"README.md"}