@openpresentation/opf-editor 0.11.3 → 0.14.2

package/dist/design-controls.js

@@ -143,7 +143,7 @@ export function createDesignControls(container, options = {}) {
   };
   const reselect = (blockPath) => {
     if (!blockPath || !options.onSelectPath) return;
-    const content = readBlockContent(editor.document, blockPath);
+    const content = readBlockContent(editor.presentation, blockPath);
     options.onSelectPath(content && !content.explicit ? `${blockPath}.${content.key}` : blockPath);
   };
   /** Run a change; report its outcome; on failure restore every control to the document. */
@@ -299,7 +299,7 @@ export function createDesignControls(container, options = {}) {
       help: "Describes the image for screen readers. Saved with the image's asset; typed before an upload, it is used for that upload. Press Enter to apply.",
       onCommit: (value) => {
         const id = assetIdOf(lastRef);
-        if (!id || editor.document.assets?.[id] === undefined) return;
+        if (!id || editor.presentation.assets?.[id] === undefined) return;
         run(() => setAssetAlt(editor, id, value), "Alt text saved.");
       },
     });
@@ -333,7 +333,7 @@ export function createDesignControls(container, options = {}) {
         source.setList(assetList());
         source.set(lastRef, note);
         const id = assetIdOf(lastRef);
-        const entry = id ? editor.document.assets?.[id] : undefined;
+        const entry = id ? editor.presentation.assets?.[id] : undefined;
         // Alt text belongs to one image: another target (variant, zone, slide) never inherits what was typed for the last one.
         alt.set(entry && typeof entry === "object" && typeof entry.alt === "string" ? entry.alt : "");
         // The field keeps what is being typed, except when the image it describes has changed.
@@ -372,7 +372,7 @@ export function createDesignControls(container, options = {}) {
     root.append(scopeField.wrap);
   }
 
-  const assetList = () => Object.keys(editor.document.assets ?? {}).map((id) => `asset:${id}`);
+  const assetList = () => Object.keys(editor.presentation.assets ?? {}).map((id) => `asset:${id}`);
   const stringOf = (value) => (typeof value === "string" ? value : value && typeof value === "object" && typeof value.src === "string" ? value.src : "");
   const isCustomObject = (value) => Boolean(value) && typeof value === "object";
 
@@ -392,8 +392,8 @@ export function createDesignControls(container, options = {}) {
       });
       body.append(field.wrap);
       syncs.push(() => {
-        field.setOptions(listSwitchOptions(editor.document, dimension, catalogOptions()).map((entry) => ({ value: entry.id, label: entry.label })));
-        const current = currentSwitchValue(editor.document, dimension, perSlide ? scoped() : {});
+        field.setOptions(listSwitchOptions(editor.presentation, dimension, catalogOptions()).map((entry) => ({ value: entry.id, label: entry.label })));
+        const current = currentSwitchValue(editor.presentation, dimension, perSlide ? scoped() : {});
         field.set(current.value, perSlide ? sourceNote(current.scope, current.value !== undefined) : "");
       });
       return field;
@@ -409,8 +409,8 @@ export function createDesignControls(container, options = {}) {
     });
     body.append(slideSize.wrap);
     syncs.push(() => {
-      slideSize.setOptions(listSwitchOptions(editor.document, "slide-sizes").map((entry) => ({ value: entry.id, label: entry.label })));
-      const { value } = currentSwitchValue(editor.document, "slide-sizes");
+      slideSize.setOptions(listSwitchOptions(editor.presentation, "slide-sizes").map((entry) => ({ value: entry.id, label: entry.label })));
+      const { value } = currentSwitchValue(editor.presentation, "slide-sizes");
       slideSize.set(value && typeof value === "object" ? "Custom size" : value);
     });
 
@@ -420,8 +420,8 @@ export function createDesignControls(container, options = {}) {
     });
     body.append(layout.wrap);
     syncs.push(() => {
-      layout.setOptions(listSwitchOptions(editor.document, "layouts", catalogOptions()).map((entry) => ({ value: entry.id, label: entry.label })));
-      layout.set(currentSwitchValue(editor.document, "layouts", { slideIndex: getSlide() }).value);
+      layout.setOptions(listSwitchOptions(editor.presentation, "layouts", catalogOptions()).map((entry) => ({ value: entry.id, label: entry.label })));
+      layout.set(currentSwitchValue(editor.presentation, "layouts", { slideIndex: getSlide() }).value);
     });
   }
 
@@ -525,7 +525,7 @@ export function createDesignControls(container, options = {}) {
     body.append(typeSelect.wrap, themePanel, solidPanel, gradientPanel, imagePanel, patternPanel, opacity.wrap, h("div", { class: "opf-dc-actions" }, apply, remove));
 
     const load = () => {
-      const current = readBackground(editor.document, scoped());
+      const current = readBackground(editor.presentation, scoped());
       const note = sourceNote(current.scope, current.type !== undefined);
       typeSelect.set(current.type ?? "theme", note);
       slot.set(current.type === "theme" ? current.slot : "light1");
@@ -592,10 +592,10 @@ export function createDesignControls(container, options = {}) {
       onCommit: (value) => image({ size: value }, "Image size changed."),
     });
     const inset = checkField("image-inset", "Inset inside the slide padding", { onChange: (checked) => image({ inset: checked ? true : null }, "Image inset changed.") });
-    const placeholderFill = selectField("image-placeholder-fill", "Picture placeholders", {
+    const placeholderFill = selectField("image-placeholder-fill", "Image placeholders", {
       empty: "Presentation default",
-      help: "How pictures fill their layout placeholders across the presentation.",
-      onChange: (value) => run(() => switchDimension(editor, "image-treatments", { imageFill: value === "" ? null : value }), "Picture placeholder fill changed."),
+      help: "How images fill their layout placeholders across the presentation.",
+      onChange: (value) => run(() => switchDimension(editor, "image-treatments", { imageFill: value === "" ? null : value }), "Image placeholder fill changed."),
     });
     placeholderFill.setOptions([
       { value: "crop", label: "Crop to fill" },
@@ -603,7 +603,7 @@ export function createDesignControls(container, options = {}) {
     ]);
     body.append(position.wrap, source.wrap, fill.wrap, shape.wrap, size.wrap, inset.wrap, placeholderFill.wrap);
     syncs.push(() => {
-      const option = getDesignOption(editor.document, "slideImage", scoped());
+      const option = getDesignOption(editor.presentation, "slideImage", scoped());
       const value = option.value;
       const object = value && typeof value === "object" && !Array.isArray(value) && value.position ? value : undefined;
       const note = sourceNote(option.scope, option.value !== undefined);
@@ -615,7 +615,7 @@ export function createDesignControls(container, options = {}) {
       inset.set(object?.inset === true);
       // Fit, shape, size and inset only make sense once the image has a position.
       for (const control of [fill, shape, size, inset]) control.wrap.hidden = !object;
-      placeholderFill.set(editor.document.design?.imageFill ?? "");
+      placeholderFill.set(editor.presentation.design?.imageFill ?? "");
     });
   }
 
@@ -632,7 +632,7 @@ export function createDesignControls(container, options = {}) {
       { value: "footer", label: "Footer" },
     ]);
     furniture.set(pick.which);
-    const zoneSelect = selectField("hf-zone", "Zone", { help: "Each zone stacks its parts top to bottom: logo, image, text, organization, socials, section, slide number, date." });
+    const zoneSelect = selectField("hf-zone", "Zone", { help: "Each zone stacks its parts top to bottom: logo, image, text, organization, speaker, socials, section, slide number, date." });
     zoneSelect.setOptions(HEADER_FOOTER_ZONES.map((value) => ({ value, label: titleCase(value) })));
     zoneSelect.set(pick.zone);
     furniture.select.addEventListener("change", () => {
@@ -678,22 +678,23 @@ export function createDesignControls(container, options = {}) {
       onCommit: (value) => edit({ dateFormat: value.trim() }, `${where()} date format changed.`),
     });
     const organization = checkField("hf-organization", "Show the organization name", { onChange: (checked) => edit({ organization: checked }, `${where()} organization ${checked ? "shown" : "removed"}.`) });
+    const speaker = checkField("hf-speaker", "Show the speaker name and title", { onChange: (checked) => edit({ speaker: checked }, `${where()} speaker ${checked ? "shown" : "removed"}.`) });
     const socials = checkField("hf-socials", "Show the organization's social profiles", { onChange: (checked) => edit({ socials: checked }, `${where()} social profiles ${checked ? "shown" : "removed"}.`) });
     const section = checkField("hf-section", "Show the section label", { onChange: (checked) => edit({ section: checked }, `${where()} section label ${checked ? "shown" : "removed"}.`) });
     const summary = h("ul", { class: "opf-dc-summary", "aria-label": "Zones in use" });
     const warnings = h("ul", { class: "opf-dc-warnings", "aria-label": "Header and footer warnings" });
-    const controls = [text, logo, image, number, numberFormat, dateNow, dateFixed, dateFormat, organization, socials, section];
+    const controls = [text, logo, image, number, numberFormat, dateNow, dateFixed, dateFormat, organization, speaker, socials, section];
     body.append(furniture.wrap, hide.wrap, zoneSelect.wrap, summary, ...controls.map((control) => control.wrap), warnings);
     const describe = (fields) =>
       Object.entries(fields)
         .map(([key, value]) => (typeof value === "boolean" ? key : `${key} ${typeof value === "string" ? `“${value}”` : ""}`.trim()))
         .join(", ");
     syncs.push(() => {
-      const state = headerFooterState(editor.document, which(), scoped());
+      const state = headerFooterState(editor.presentation, which(), scoped());
       // Offered on a slide that inherits the deck's furniture or already hides it, never over zones the slide set itself; at the deck only to undo a hidden state.
       hide.wrap.hidden = scopeIndex() === undefined ? !state.hidden : state.own && !state.hidden;
       hide.set(state.hidden, state.inherited && !state.hidden ? "from the presentation" : "");
-      const fields = readHeaderFooterZone(editor.document, which(), zone(), scoped());
+      const fields = readHeaderFooterZone(editor.presentation, which(), zone(), scoped());
       text.set(typeof fields.text === "string" ? fields.text : "");
       logo.set(fields.logo === true);
       image.set(stringOf(fields.image), "", `${target()}:${which()}:${zone()}`);
@@ -703,16 +704,17 @@ export function createDesignControls(container, options = {}) {
       dateFixed.set(typeof fields.date === "string" ? fields.date : "");
       dateFormat.set(typeof fields.dateFormat === "string" ? fields.dateFormat : "");
       organization.set(fields.organization === true);
+      speaker.set(fields.speaker === true);
       socials.set(fields.socials === true);
       section.set(fields.section === true);
       for (const control of controls) for (const input of control.wrap.querySelectorAll("input,select,button")) input.disabled = state.hidden;
       summary.replaceChildren(
         ...HEADER_FOOTER_ZONES.map((name) => {
-          const zoneFields = readHeaderFooterZone(editor.document, which(), name, scoped());
+          const zoneFields = readHeaderFooterZone(editor.presentation, which(), name, scoped());
           return h("li", {}, `${titleCase(name)}: ${Object.keys(zoneFields).length ? describe(zoneFields) : "empty"}`);
         }),
       );
-      warnings.replaceChildren(...designWarnings(editor.document, getSlide()).filter((warning) => /^design\.(header|footer)/.test(warning.path)).map((warning) => h("li", {}, warning.message)));
+      warnings.replaceChildren(...designWarnings(editor.presentation, getSlide()).filter((warning) => /^design\.(header|footer)/.test(warning.path)).map((warning) => h("li", {}, warning.message)));
     });
   }
 
@@ -752,6 +754,18 @@ export function createDesignControls(container, options = {}) {
       apply: (ref) => setDesignOption(editor, "watermark", ref === null ? null : { src: ref }, scoped()),
       build: (ref, doc) => prepareDesignOption(doc, "watermark", { src: ref }, scoped()),
     });
+    // FA-13: a watermark is an image or a text stamp; the text field and the image cluster replace each other.
+    const watermarkText = textField("watermark-text", "Watermark text", {
+      placeholder: "DRAFT",
+      help: "A text stamp centered on the slide, drawn diagonally in the theme text color at the opacity below. Press Enter to apply; clear the field to remove it. It replaces a watermark image.",
+      onCommit: (value) => run(() => {
+        const text = value.trim();
+        const current = getDesignOption(editor.presentation, "watermark", scoped()).value;
+        if (text === "") return current && typeof current === "object" && typeof current.text === "string" ? setDesignOption(editor, "watermark", null, scoped()) : { changed: false };
+        const opacity = current && typeof current === "object" && typeof current.opacity === "number" ? current.opacity : 0.1;
+        return setDesignOption(editor, "watermark", { text, opacity }, scoped());
+      }, value.trim() === "" ? "Watermark removed." : "Watermark text set."),
+    });
     const watermarkOpacity = numberField("watermark-opacity", "Watermark opacity (0 to 1)", {
       min: 0,
       max: 1,
@@ -761,30 +775,31 @@ export function createDesignControls(container, options = {}) {
     const watermarkOff = checkField("watermark-off", "Hide the inherited watermark", {
       onChange: (checked) => run(() => setDesignOption(editor, "watermark", checked ? false : null, scoped()), checked ? "Watermark hidden." : "Watermark restored."),
     });
-    body.append(variant.wrap, logoSource.wrap, orgLogo.wrap, bullet.wrap, accent.wrap, watermarkSource.wrap, watermarkOpacity.wrap, watermarkOff.wrap);
+    body.append(variant.wrap, logoSource.wrap, orgLogo.wrap, bullet.wrap, accent.wrap, watermarkSource.wrap, watermarkText.wrap, watermarkOpacity.wrap, watermarkOff.wrap);
     const warningList = h("ul", { class: "opf-dc-warnings", "aria-label": "Logo warnings" });
     body.append(warningList);
     syncs.push(() => {
-      const variants = readLogoVariants(editor.document, scoped());
+      const variants = readLogoVariants(editor.presentation, scoped());
       logoSource.set(stringOf(variants[variant.select.value]), "", `${target()}:${variant.select.value}`);
-      const organization = editor.document.organization;
+      const organization = editor.presentation.organization;
       const owner = Array.isArray(organization) ? organization[0] : organization;
       orgLogo.set(stringOf(owner?.logo), "", "org");
       for (const input of orgLogo.wrap.querySelectorAll("input")) input.disabled = !owner;
-      const bulletOption = getDesignOption(editor.document, "listBullet", scoped());
+      const bulletOption = getDesignOption(editor.presentation, "listBullet", scoped());
       bullet.set(bulletOption.value ?? "", sourceNote(bulletOption.scope, bulletOption.value !== undefined));
-      const accentOption = getDesignOption(editor.document, "accentFont", scoped());
+      const accentOption = getDesignOption(editor.presentation, "accentFont", scoped());
       accent.set(accentOption.value ?? "", sourceNote(accentOption.scope, accentOption.value !== undefined));
-      const watermark = getDesignOption(editor.document, "watermark", scoped());
+      const watermark = getDesignOption(editor.presentation, "watermark", scoped());
       const mark = watermark.value;
-      // The opacity belongs to a watermark image; without one there is nothing to fade.
-      for (const input of watermarkOpacity.wrap.querySelectorAll("input")) input.disabled = !(typeof mark === "string" || (mark && typeof mark === "object" && typeof mark.src === "string"));
+      // The opacity belongs to a watermark image or text; without one there is nothing to fade.
+      for (const input of watermarkOpacity.wrap.querySelectorAll("input")) input.disabled = !(typeof mark === "string" || (mark && typeof mark === "object" && (typeof mark.src === "string" || typeof mark.text === "string")));
+      watermarkText.set(mark && typeof mark === "object" && typeof mark.text === "string" ? mark.text : "", sourceNote(watermark.scope, mark !== undefined));
       watermarkSource.set(typeof mark === "string" ? mark : mark && typeof mark === "object" ? stringOf(mark) : "", sourceNote(watermark.scope, mark !== undefined), target());
       watermarkOpacity.set(mark && typeof mark === "object" && typeof mark.opacity === "number" ? String(mark.opacity) : "");
-      const own = scopeIndex() === undefined ? editor.document.design?.watermark : editor.document.slides?.[scopeIndex()]?.design?.watermark;
+      const own = scopeIndex() === undefined ? editor.presentation.design?.watermark : editor.presentation.slides?.[scopeIndex()]?.design?.watermark;
       watermarkOff.set(own === false);
       watermarkOff.wrap.hidden = state.scope !== "slide";
-      warningList.replaceChildren(...designWarnings(editor.document, getSlide()).filter((warning) => warning.path === "design.listBullet").map((warning) => h("li", {}, warning.message)));
+      warningList.replaceChildren(...designWarnings(editor.presentation, getSlide()).filter((warning) => warning.path === "design.listBullet").map((warning) => h("li", {}, warning.message)));
     });
   }
 
@@ -801,7 +816,7 @@ export function createDesignControls(container, options = {}) {
       field.setOptions(values.map((value) => ({ value, label: labels[value] ?? titleCase(value) })));
       body.append(field.wrap);
       syncs.push(() => {
-        const option = getDesignOption(editor.document, id, scoped());
+        const option = getDesignOption(editor.presentation, id, scoped());
         field.set(option.value ?? "", sourceNote(option.scope, option.value !== undefined));
       });
     };
@@ -819,7 +834,7 @@ export function createDesignControls(container, options = {}) {
     ]);
     body.append(box.wrap);
     syncs.push(() => {
-      const option = getDesignOption(editor.document, "contentBox", scoped());
+      const option = getDesignOption(editor.presentation, "contentBox", scoped());
       box.set(option.value === undefined ? "" : option.value ? "yes" : "no", sourceNote(option.scope, option.value !== undefined));
     });
   }
@@ -832,11 +847,11 @@ export function createDesignControls(container, options = {}) {
       const field = selectField(name, label, { help, onChange: (value) => run(() => switchDimension(editor, dimension, value, catalogOptions()), `${label} set to ${field.select.selectedOptions[0]?.textContent ?? value}.`) });
       body.append(field.wrap);
       syncs.push(() => {
-        field.setOptions(listSwitchOptions(editor.document, dimension, catalogOptions()).map((entry) => ({ value: entry.id, label: entry.label })));
-        field.set(currentSwitchValue(editor.document, dimension).value);
+        field.setOptions(listSwitchOptions(editor.presentation, dimension, catalogOptions()).map((entry) => ({ value: entry.id, label: entry.label })));
+        field.set(currentSwitchValue(editor.presentation, dimension).value);
       });
     };
-    single("narrative", "Narrative", "narratives", "The storyline the deck follows. Authoring metadata: the slides do not change.");
+    single("narrative", "Narrative", "narratives", "The narrative plan the deck points at (a catalog id; a custom one is a record in the JSON source). The slides do not change, and keep their beat links.");
     single("tone", "Tone", "tones");
     single("purpose", "Purpose", "purposes", "What the deck is for. Authoring metadata: the slides do not change. A goal written in the JSON source shows as custom.");
     const audience = selectField("audience", "Audience", {
@@ -850,9 +865,11 @@ export function createDesignControls(container, options = {}) {
     });
     body.append(audience.wrap);
     syncs.push(() => {
-      audience.setOptions(listSwitchOptions(editor.document, "audiences", catalogOptions()).map((entry) => ({ value: entry.id, label: entry.label })));
-      const value = editor.document.audience;
-      audience.set(Array.isArray(value) ? value : value === undefined ? [] : [value]);
+      audience.setOptions(listSwitchOptions(editor.presentation, "audiences", catalogOptions()).map((entry) => ({ value: entry.id, label: entry.label })));
+      // The root audience is a string, one inline Audience object or an array of both: the picker shows the catalog ids.
+      const value = editor.presentation.audience;
+      const entries = Array.isArray(value) ? value : value === undefined ? [] : [value];
+      audience.set(entries.map((entry) => (entry && typeof entry === "object" ? entry.id : entry)).filter((id) => typeof id === "string"));
     });
 
     const owner = selectField("social-owner", "Socials belong to");
@@ -866,17 +883,17 @@ export function createDesignControls(container, options = {}) {
     handle.input.addEventListener("change", applySocial);
     body.append(owner.wrap, platform.wrap, handle.wrap, button("Save handle", applySocial));
     const showHandle = () => {
-      const host = editor.document[owner.select.value];
+      const host = editor.presentation[owner.select.value];
       const target = Array.isArray(host) ? host[0] : host;
       handle.set(typeof target?.socials?.[platform.select.value] === "string" ? target.socials[platform.select.value] : "");
     };
     owner.select.addEventListener("change", showHandle);
     platform.select.addEventListener("change", showHandle);
     syncs.push(() => {
-      const owners = ["speaker", "organization"].filter((name) => editor.document[name]);
+      const owners = ["speaker", "organization"].filter((name) => editor.presentation[name]);
       owner.setOptions(owners.length ? owners.map((name) => ({ value: name, label: titleCase(name) })) : [{ value: "speaker", label: "Speaker (add one first)", disabled: true }]);
       if (!owner.select.value || !owners.includes(owner.select.value)) owner.select.value = owners[0] ?? "speaker";
-      platform.setOptions(listSwitchOptions(editor.document, "socials", catalogOptions()).map((entry) => ({ value: entry.id, label: entry.label })));
+      platform.setOptions(listSwitchOptions(editor.presentation, "socials", catalogOptions()).map((entry) => ({ value: entry.id, label: entry.label })));
       showHandle();
     });
   }
@@ -972,7 +989,7 @@ export function createDesignControls(container, options = {}) {
 
   function syncSelection() {
     const selected = getSelected();
-    const document_ = editor.document;
+    const document_ = editor.presentation;
     const blockPath = selected ? blockPathForSelection(document_, selected) : undefined;
     const content = blockPath ? readBlockContent(document_, blockPath) : undefined;
     dynamic.blockPath = blockPath;
@@ -1009,9 +1026,11 @@ export function createDesignControls(container, options = {}) {
       const tablePath = parsed?.tablePath ?? (content?.key === "table" ? `${blockPath}.table` : undefined);
       dynamic.tablePath = tablePath;
       dynamic.cell = parsed?.cell;
-      tableUi.details.hidden = !tablePath;
-      if (tablePath) {
-        const table = editor.get(tablePath);
+      // A table that shows a shared dataset (RR-54) has no cell styles or merges: the table panel is for inline tables.
+      const tableValue = tablePath ? editor.get(tablePath) : undefined;
+      tableUi.details.hidden = !tablePath || !Array.isArray(tableValue?.rows);
+      if (tablePath && !tableUi.details.hidden) {
+        const table = tableValue;
         tableUi.summary.textContent = `Table (${tablePath})`;
         const style = readTableStyle(document_, tablePath);
         dynamic.tableStyle = style.preset === "custom" ? { header: "theme", banding: false, borders: "theme" } : { header: style.header, banding: style.banding, borders: style.borders };

package/dist/design-options.d.ts

@@ -25,7 +25,7 @@ export declare const DESIGN_OPTIONS: readonly DesignOptionDescriptor[];
 export declare const LOGO_VARIANTS: readonly ["default", "light", "dark", "stacked", "stackedLight", "stackedDark", "icon", "iconLight", "iconDark", "wordmark", "wordmarkLight", "wordmarkDark"];
 export type LogoVariant = (typeof LOGO_VARIANTS)[number];
 /** Every field a header or footer zone can hold. */
-export declare const ZONE_FIELDS: readonly ["logo", "text", "image", "slideNumber", "slideNumberFormat", "date", "dateFormat", "organization", "socials", "section"];
+export declare const ZONE_FIELDS: readonly ["logo", "text", "image", "slideNumber", "slideNumberFormat", "date", "dateFormat", "organization", "speaker", "socials", "section"];
 /** Date format tokens (English names). */
 export declare const DATE_FORMAT_TOKENS: readonly string[];
 export declare const HEADER_FOOTER_ZONES: readonly ["left", "center", "right"];
@@ -53,7 +53,7 @@ export interface PreparedDesignOption {
   /** The logo variant or header/footer zone an edit named. */
   variant?: string;
   zone?: string;
-  document: unknown;
+  presentation: unknown;
   patches: JsonPatchOperation[];
   changed: boolean;
   /** Slides whose own design hides a deck-level change. */
@@ -61,8 +61,8 @@ export interface PreparedDesignOption {
   /** Settings that need a logo the document does not have. */
   warnings: DesignWarning[];
 }
-export interface DesignOptionChange extends Omit<EditorChange, "document" | "patches"> {
-  document: unknown;
+export interface DesignOptionChange extends Omit<EditorChange, "presentation" | "patches"> {
+  presentation: unknown;
   patches: JsonPatchOperation[];
   option: string;
   scope: "deck" | "slide";
@@ -73,16 +73,16 @@ export interface DesignOptionChange extends Omit<EditorChange, "document" | "pat
 }
 
 /** Compute the patch for one option. `null` removes it at that scope; object options (watermark, slideImage) merge the fields passed. */
-export declare function prepareDesignOption(document: unknown, option: DesignOptionId, value: unknown, options?: DesignOptionOptions): PreparedDesignOption;
+export declare function prepareDesignOption(presentation: unknown, option: DesignOptionId, value: unknown, options?: DesignOptionOptions): PreparedDesignOption;
 /** Set one option as a single undoable transaction. */
 export declare function setDesignOption(editor: EditorSession, option: DesignOptionId, value: unknown, options?: DesignOptionOptions): DesignOptionChange;
 /** `{ value, scope, inherited }`; scope is "slide", "deck" or "default". */
-export declare function getDesignOption(document: unknown, option: DesignOptionId, options?: Pick<DesignOptionOptions, "slideIndex" | "index">): { value: unknown; scope: "slide" | "deck" | "default"; inherited: boolean };
-export declare function prepareLogoVariant(document: unknown, variant: LogoVariant, source: string | Record<string, unknown> | null, options?: DesignOptionOptions): PreparedDesignOption;
+export declare function getDesignOption(presentation: unknown, option: DesignOptionId, options?: Pick<DesignOptionOptions, "slideIndex" | "index">): { value: unknown; scope: "slide" | "deck" | "default"; inherited: boolean };
+export declare function prepareLogoVariant(presentation: unknown, variant: LogoVariant, source: string | Record<string, unknown> | null, options?: DesignOptionOptions): PreparedDesignOption;
 /** Set or clear one `design.logo` variant; a lone default stays a bare source. */
 export declare function setLogoVariant(editor: EditorSession, variant: LogoVariant, source: string | Record<string, unknown> | null, options?: DesignOptionOptions): DesignOptionChange;
 /** The variants `design.logo` sets at a scope (a bare logo is reported as `default`). */
-export declare function readLogoVariants(document: unknown, options?: Pick<DesignOptionOptions, "slideIndex">): Partial<Record<LogoVariant, unknown>>;
+export declare function readLogoVariants(presentation: unknown, options?: Pick<DesignOptionOptions, "slideIndex">): Partial<Record<LogoVariant, unknown>>;
 export interface HeaderFooterZoneFields {
   logo?: boolean | null;
   text?: string | null;
@@ -92,17 +92,19 @@ export interface HeaderFooterZoneFields {
   date?: boolean | string | null;
   dateFormat?: string | null;
   organization?: boolean | null;
+  /** The first speaker's name and title ("Ada Lovelace, CTO"). */
+  speaker?: boolean | null;
   socials?: boolean | null;
   section?: boolean | null;
 }
-export declare function prepareHeaderFooterZone(document: unknown, which: "header" | "footer", zone: HeaderFooterZone, fields: HeaderFooterZoneFields, options?: DesignOptionOptions): PreparedDesignOption;
+export declare function prepareHeaderFooterZone(presentation: unknown, which: "header" | "footer", zone: HeaderFooterZone, fields: HeaderFooterZoneFields, options?: DesignOptionOptions): PreparedDesignOption;
 /** Merge fields into one header or footer zone; null, false (flags) or "" remove a field, an empty zone and header are removed. A slide's own header replaces the deck's whole one, so the first edit on a slide starts from a copy of the deck's and keeps its other zones. */
 export declare function setHeaderFooterZone(editor: EditorSession, which: "header" | "footer", zone: HeaderFooterZone, fields: HeaderFooterZoneFields, options?: DesignOptionOptions): DesignOptionChange;
 /** One zone's fields as they apply at a scope: the slide's own header or footer when it has one, else the deck's. */
-export declare function readHeaderFooterZone(document: unknown, which: "header" | "footer", zone: HeaderFooterZone, options?: Pick<DesignOptionOptions, "slideIndex">): HeaderFooterZoneFields;
+export declare function readHeaderFooterZone(presentation: unknown, which: "header" | "footer", zone: HeaderFooterZone, options?: Pick<DesignOptionOptions, "slideIndex">): HeaderFooterZoneFields;
 /** Whether the scope sets the header or footer itself (`own`), shows the deck's (`inherited`) or hides it with `false` (`hidden`). */
-export declare function headerFooterState(document: unknown, which: "header" | "footer", options?: Pick<DesignOptionOptions, "slideIndex">): { own: boolean; inherited: boolean; hidden: boolean };
+export declare function headerFooterState(presentation: unknown, which: "header" | "footer", options?: Pick<DesignOptionOptions, "slideIndex">): { own: boolean; inherited: boolean; hidden: boolean };
 /** Whether a logo resolves for the slide: slide design, deck design, then the primary organization. */
-export declare function hasResolvableLogo(document: unknown, slideIndex: number): boolean;
-/** Settings that need content the document does not have: a logo (zones with `logo: true`, picture bullets), or an organization or its social profiles for zones that show them. */
-export declare function designWarnings(document: unknown, slideIndex?: number): DesignWarning[];
+export declare function hasResolvableLogo(presentation: unknown, slideIndex: number): boolean;
+/** Settings that need content the document does not have: a logo (zones with `logo: true`, picture bullets), an organization or its social profiles, or a named speaker, for zones that show them. */
+export declare function designWarnings(presentation: unknown, slideIndex?: number): DesignWarning[];