@openpresentation/opf-editor 0.11.3 → 0.14.2

package/dist/json-options.js

@@ -1,4 +1,5 @@
-import { catalogKinds, catalogSchemaNames, schemas, validateCatalogRecord, validatePresentation } from "@openpresentation/opf";
+import { catalogKinds, catalogSchemaNames, schemas, validateCatalogRecord } from "@openpresentation/opf";
+import { checkFormat, firstErrorMessage } from "./checks.js";
 import { getCatalogOptions } from "./index.js";
 import { schemaAtPath, schemaVariants } from "./schema.js";
 import { applyEdits, findNodeAtLocation, findNodeAtOffset, getNodePath, modify, parseTree } from "jsonc-parser";
@@ -19,8 +20,8 @@ function placeholderSummary(types) {
         return "Placeholders not specified";
     if (!types.length)
         return "No placeholders";
-    const labels = { title: "Title", subtitle: "Subtitle", text: "Text", metric: "Metric", list: "List", picture: "Image", chart: "Chart", table: "Table", code: "Code", media: "Video", quote: "Quote", timeline: "Timeline", tag: "Tag", diagram: "Image" };
-    const order = ["title", "subtitle", "text", "metric", "list", "picture", "chart", "table", "code", "media", "quote", "timeline", "tag", "diagram"];
+    const labels = { title: "Title", subtitle: "Subtitle", tag: "Tag", text: "Text", list: "List", image: "Image", video: "Video", chart: "Chart", table: "Table", code: "Code", metric: "Metric", quote: "Quote", timeline: "Timeline" };
+    const order = ["title", "subtitle", "tag", "text", "list", "image", "video", "chart", "table", "code", "metric", "quote", "timeline"];
     return [...new Set(types)].sort((a, b) => order.indexOf(a) - order.indexOf(b)).map(type => {
         const count = types.filter(value => value === type).length;
         return `${labels[type] ?? type}${count > 1 ? ` × ${count}` : ""}`;
@@ -64,9 +65,9 @@ function describeOptions(choices, records, current, catalog) {
 // The installed schema identifies fields; a document field merely named "layout"
 // inside arbitrary metadata is not mistaken for an OPF layout reference.
 export function getJsonFieldContext(source, position, loadedCatalogs = {}) {
-    let document;
+    let presentation;
     try {
-        document = JSON.parse(source);
+        presentation = JSON.parse(source);
     }
     catch {
         return null;
@@ -84,18 +85,18 @@ export function getJsonFieldContext(source, position, loadedCatalogs = {}) {
     const path = getNodePath(node);
     if (!path.length)
         return null;
-    const schema = schemaAtPath(document, path.map(String));
+    const schema = schemaAtPath(presentation, path.map(String));
     const variants = schemaVariants(schema);
     const description = String(schema.description ?? "");
     let catalog = catalogFor(description);
     // Audience arrays inherit the catalog context from the array property.
     if (!catalog && typeof path.at(-1) === "number")
-        catalog = catalogFor(String(schemaAtPath(document, path.slice(0, -1).map(String)).description ?? ""));
+        catalog = catalogFor(String(schemaAtPath(presentation, path.slice(0, -1).map(String)).description ?? ""));
     const options = new Map();
     const records = new Map();
     let unloadedSource = false;
     if (catalog && typeof node.value === "string") {
-        const entries = document.catalogs;
+        const entries = presentation.catalogs;
         const local = entries?.[catalog];
         unloadedSource = Boolean(local?.source);
         for (const option of getCatalogOptions(catalog)) {
@@ -148,18 +149,18 @@ export function replaceFieldOption(context, value) {
     if (!context.options.some(option => option.value === value))
         throw new Error("This choice is no longer available.");
     let next = context.source.slice(0, context.offset) + JSON.stringify(value) + context.source.slice(context.offset + context.length);
-    const document = JSON.parse(next);
-    if (context.path.reduce((current, key) => current?.[key], document) !== value)
+    const presentation = JSON.parse(next);
+    if (context.path.reduce((current, key) => current?.[key], presentation) !== value)
         throw new Error("This field has a duplicate key. Resolve it in the JSON before choosing an option.");
     const types = context.options.find(option => option.value === value).placeholderTypes;
     if (value !== context.value && types && context.catalog === 'layouts' && context.path.length === 3
-        && context.path[0] === 'slides' && context.path[2] === 'layout' && validatePresentation(document).valid) {
-        const populated = populateLayoutPlaceholders(document, context.path[1], types);
-        next = updateSource(next, document, populated);
+        && context.path[0] === 'slides' && context.path[2] === 'layout' && checkFormat(presentation).valid) {
+        const populated = populateLayoutPlaceholders(presentation, context.path[1], types);
+        next = updateSource(next, presentation, populated);
     }
-    const result = validatePresentation(JSON.parse(next));
-    if (!result.valid && validatePresentation(JSON.parse(context.source)).valid)
-        throw new Error(result.errors[0]?.message ?? "This option is not valid here.");
+    const result = checkFormat(JSON.parse(next));
+    if (!result.valid && checkFormat(JSON.parse(context.source)).valid)
+        throw new Error(firstErrorMessage(result, "This option is not valid here."));
     return next;
 }
 

package/dist/layout-handles.js

@@ -22,11 +22,11 @@ export function createLayoutHandles(root, options) {
     const edit=active;
     edit.fraction=fraction;
     try{
-      const prepared=prepareTrackResize(editor.document,active.flow,active.boundary,fraction);
-      options.render(prepared.document);
+      const prepared=prepareTrackResize(editor.presentation,active.flow,active.boundary,fraction);
+      options.render(prepared.presentation);
       if(active!==edit)return false;
       edit.prepared=prepared;edit.valid=true;
-      options.onDraft?.({document:prepared.document,path:active.flow.path+'.composition',value:prepared.composition});
+      options.onDraft?.({presentation:prepared.presentation,path:active.flow.path+'.composition',value:prepared.composition});
       if(active!==edit)return false;
       options.clearError?.();return true;
     }catch(error){if(active===edit)edit.valid=false;options.onError(error);return false;}
@@ -41,7 +41,7 @@ export function createLayoutHandles(root, options) {
     active=null;release(edit);committing=true;
     try{
       // Rebase unrelated document edits, retaining the guarded container.
-      const prepared=prepareTrackResize(editor.document,edit.flow,edit.boundary,edit.fraction);
+      const prepared=prepareTrackResize(editor.presentation,edit.flow,edit.boundary,edit.fraction);
       if(edit.moved)editor.applyPatch(prepared.patches,{source:'canvas-layout',rejectInvalid:true});
       else renderCanonical();
       options.onCommit?.({path:edit.flow.path+'.composition',editor});return true;
@@ -56,7 +56,7 @@ export function createLayoutHandles(root, options) {
     if(event)layer.setPointerCapture(event.pointerId);
     return true;
   }
-  function update(document,geometry) {
+  function update(presentation,geometry) {
     lastGeometry=geometry;
     layer.replaceChildren();
     if(!enabled||options.isTextEditing())return;

package/dist/layout-placeholders.js

@@ -2,7 +2,7 @@ import {listBlockContainers,prepareBlockInsert} from './blocks.js';
 
 const payloadFields=['text','items','bullets','image','video','chart','table','code','metric','quote','timeline'];
 const headingFields=new Set(['title','subtitle','tag']);
-const fields={text:'text',list:'items',picture:'image',media:'video',diagram:'image',chart:'chart',table:'table',code:'code',metric:'metric',quote:'quote',timeline:'timeline'};
+const fields={text:'text',list:'items',image:'image',video:'video',chart:'chart',table:'table',code:'code',metric:'metric',quote:'quote',timeline:'timeline'};
 const region=key=>/^(?:(?:top|middle|bottom)(?:\+(?:top|middle|bottom))*(?::(?:left|center|right)(?:\+(?:left|center|right))*)?|(?:left|center|right)(?:\+(?:left|center|right))*)$/.test(key);
 
 function emptyPayload(field){
@@ -16,8 +16,8 @@ function emptyPayload(field){
 }
 
 /** Supply authored slots without replacing content, metadata or region placement. */
-export function populateLayoutPlaceholders(document,slideIndex,types){
-  let next=structuredClone(document),slide=next.slides[slideIndex];
+export function populateLayoutPlaceholders(presentation,slideIndex,types){
+  let next=structuredClone(presentation),slide=next.slides[slideIndex];
   const counts=new Map();
   function count(host){
     if(!host||typeof host!=='object')return;
@@ -48,7 +48,7 @@ export function populateLayoutPlaceholders(document,slideIndex,types){
       const path=regions.length?`/slides/${slideIndex}/${regions.at(-1)}`:`/slides/${slideIndex}`;
       const containers=listBlockContainers(next,{slideIndex,includeImplicit:true});
       if(!containers.some(container=>container.path===path))throw new Error('This slide has no editable content container for the new placeholder.');
-      next=prepareBlockInsert(next,path,{[field]:value}).document;
+      next=prepareBlockInsert(next,path,{[field]:value}).presentation;
       slide=next.slides[slideIndex];
     }
   }

package/dist/layout.d.ts

@@ -1,8 +1,8 @@
 import type {ComposedFlow, Composition} from '@openpresentation/opf/composition';
 import type {JsonPatchOperation} from './index.js';
 /** Resize adjacent tracks. Fractions clamp to 5–95%; automatic flows become explicit grids. */
-export declare function prepareTrackResize(document:unknown,flow:ComposedFlow,boundary:number,fraction:number):{
-  document:unknown;patches:JsonPatchOperation[];composition:Composition;fraction:number;
+export declare function prepareTrackResize(presentation:unknown,flow:ComposedFlow,boundary:number,fraction:number):{
+  presentation:unknown;patches:JsonPatchOperation[];composition:Composition;fraction:number;
 };
 
 export {prepareBlockMove,listBlockContainers,prepareBlockInsert,prepareBlockDuplicate,prepareBlockRemove,prepareBlockReplace,createContentBlock} from './blocks.js';

package/dist/layout.js

@@ -1,7 +1,8 @@
-import {getValueAtPath, createValuePatch, applyJsonPatch, validateOpfDocument, opfPathToJsonPointer} from './index.js';
+import { getValueAtPath, createValuePatch, applyJsonPatch, opfPathToJsonPointer } from './index.js';
+import { firstErrorMessage, checkFormat } from "./checks.js";
 
 /** Prepare a validated track resize; the test operation guards its container revision. */
-export function prepareTrackResize(document, flow, boundary, fraction) {
+export function prepareTrackResize(presentation, flow, boundary, fraction) {
   const vertical = flow?.composition?.mode === 'column';
   const tracks = vertical ? flow?.rows : flow?.columns;
   if (!Array.isArray(tracks) || tracks.length < 2 || tracks.length > 12)
@@ -12,7 +13,7 @@ export function prepareTrackResize(document, flow, boundary, fraction) {
     throw new RangeError('Track boundary is out of range.');
   if (!Number.isFinite(fraction) || fraction < 0 || fraction > 1)
     throw new RangeError('Track fraction must be between zero and one.');
-  const container = getValueAtPath(document,flow.path);
+  const container = getValueAtPath(presentation,flow.path);
   if (!container || typeof container !== 'object') throw new Error('The layout container no longer exists.');
   const effective = flow.composition.weights ?? [];
   const weights = Array.from({length:Math.max(tracks.length,effective.length)},(_,index)=>effective[index]??1);
@@ -25,10 +26,10 @@ export function prepareTrackResize(document, flow, boundary, fraction) {
   const composition={...container.composition,mode:flow.composition.mode??'auto',weights};
   // A drag expresses an explicit arrangement. Preserve the automatic engine's chosen columns.
   if(composition.mode==='auto'){composition.mode='grid';composition.columns=flow.columns.length;}
-  const patches=[{op:'test',path:opfPathToJsonPointer(flow.path),value:structuredClone(container)},...createValuePatch(document,[...flow.path.split('.'),'composition'],composition)];
-  const next=applyJsonPatch(document,patches),validation=validateOpfDocument(next);
-  if(!validation.valid)throw new Error(validation.errors[0]?.message??'Track resize is not valid OPF.');
-  return {document:next,patches,composition,fraction:share};
+  const patches=[{op:'test',path:opfPathToJsonPointer(flow.path),value:structuredClone(container)},...createValuePatch(presentation,[...flow.path.split('.'),'composition'],composition)];
+  const next=applyJsonPatch(presentation,patches),validation=checkFormat(next);
+  if(!validation.valid)throw new Error(firstErrorMessage(validation, 'Track resize is not valid OPF.'));
+  return {presentation:next,patches,composition,fraction:share};
 }
 
 export {prepareBlockMove,listBlockContainers,prepareBlockInsert,prepareBlockDuplicate,prepareBlockRemove,prepareBlockReplace,createContentBlock} from './blocks.js';

package/dist/numbering-panel.js

@@ -8,7 +8,6 @@ import {
   NUMBERING_STYLE_OPTIONS,
   NUMBERING_SUFFIX_OPTIONS,
   findNumberableLists,
-  numberingAvailable,
   numberingState,
   numberingValue,
   setEntryStart,
@@ -36,7 +35,6 @@ function h(doc, tag, attributes = {}, ...children) {
  * `onStatus(message, {error})`.
  */
 export function createNumberingPanel(container, options) {
-  if (!numberingAvailable()) throw new Error("The numbering control needs a core release that ships numbering.");
   const { editor, getTarget, getSlideIndex, onStatus } = options;
   const doc = container.ownerDocument;
   const id = `opf-numbering-${++panelCounter}`;
@@ -58,9 +56,9 @@ export function createNumberingPanel(container, options) {
 
   const currentPath = () => {
     const slide = getSlideIndex?.() ?? 0;
-    const lists = findNumberableLists(editor.document, slide);
+    const lists = findNumberableLists(editor.presentation, slide);
     const wanted = explicit ?? getTarget?.();
-    if (wanted && numberingState(editor.document, wanted)) return { path: wanted, lists };
+    if (wanted && numberingState(editor.presentation, wanted)) return { path: wanted, lists };
     return { path: lists[0]?.path, lists };
   };
 
@@ -100,7 +98,7 @@ export function createNumberingPanel(container, options) {
   function draw(force = false) {
     if (destroyed) return;
     const { path, lists } = currentPath();
-    const state = path ? numberingState(editor.document, path) : undefined;
+    const state = path ? numberingState(editor.presentation, path) : undefined;
     const signature = JSON.stringify([path, state, lists.map((entry) => [entry.path, entry.numbered])]);
     if (!force && signature === drawn) return;
     drawn = signature;

package/dist/numbering.d.ts

@@ -12,8 +12,6 @@ export declare const NUMBERING_SUFFIX_OPTIONS: readonly { value: NumberingSuffix
 export declare const MAX_NUMBERING_LEVELS: 9;
 export declare const MAX_NUMBERING_START: 32767;
 
-/** True when the core this editor runs on composes numbered lists. */
-export declare function numberingAvailable(): boolean;
 
 export interface ListPayloadLocation {
   /** The payload that owns the list ("" for a document-level path is not possible; a slide, region or block). */
@@ -26,11 +24,11 @@ export interface ListPayloadLocation {
   entry?: number;
 }
 /** Where a list lives for a path that points at it or into it (`slides.0.items`, `slides.0.items.2`, `slides.0.left.items.1.text`). */
-export declare function listPayloadAt(document: unknown, path: string): ListPayloadLocation | undefined;
+export declare function listPayloadAt(presentation: unknown, path: string): ListPayloadLocation | undefined;
 
 export interface NumberableList { path: string; payloadPath: string; field: "items" | "bullets"; label: string; count: number; numbered: boolean }
 /** Every list of a slide: path, label, entry count and whether it is numbered. */
-export declare function findNumberableLists(document: unknown, slideIndex: number): NumberableList[];
+export declare function findNumberableLists(presentation: unknown, slideIndex: number): NumberableList[];
 
 /** The shortest `numbering` value for per-level settings (a style name, an object of the non-default fields, or an array). */
 export declare function numberingValue(levels: readonly Partial<NumberingLevel>[]): NumberingValue;
@@ -54,7 +52,7 @@ export interface NumberingState {
   /** The entry the path selects, with its own `start` and the marker it draws. */
   entry?: { index: number; start?: number; marker?: string };
 }
-export declare function numberingState(document: unknown, path: string): NumberingState | undefined;
+export declare function numberingState(presentation: unknown, path: string): NumberingState | undefined;
 
 /** Number a list, change its numbering, or (with `undefined` or `null`) turn it off, as one undoable validated edit. Turning it off also removes the entry `start` values. */
 export declare function setNumbering(editor: EditorSession, path: string, value: NumberingValue | undefined | null, meta?: Record<string, unknown>): unknown;

package/dist/numbering.js

@@ -1,9 +1,8 @@
 // List numbering (RR-33): the headless model behind the numbering control. A list payload (`items` or `bullets`) can
 // carry `numbering`: a style name, a { style, start, suffix } object, or an array with one entry per list level. Every
 // write goes through the session as a validated JSON Patch edit, so each change is one undoable edit. Importing this
-// module needs no DOM. Core is read from the namespace so an older core still loads this module; the writes then
-// throw "numbering-unavailable".
-import * as core from "@openpresentation/opf";
+// module needs no DOM.
+import { listNumbers } from "@openpresentation/opf/composition";
 import { OPFEditorError, getValueAtPath, opfPathToJsonPointer, splitOpfPath } from "./index.js";
 
 /** The number styles and how each draws, in the order a picker lists them. */
@@ -41,21 +40,12 @@ function checkEditor(editor) {
   }
 }
 
-/** True when the core this editor runs on composes numbered lists (the core that ships `numbering`). */
-export function numberingAvailable() {
-  return typeof core.listNumbers === "function" && typeof core.formatListNumber === "function";
-}
-
-function requireCore() {
-  if (!numberingAvailable()) throw fail("numbering-unavailable", "List numbering needs a core release that ships numbering (@openpresentation/opf after 0.11.4).");
-}
-
 /**
  * Where a list lives for a path that points at it or into it: `slides.0.items`, `slides.0.items.2` or
  * `slides.0.left.items.1.text` all resolve to the payload that owns the list. Returns undefined when the path is not
  * inside a list.
  */
-export function listPayloadAt(document, path) {
+export function listPayloadAt(presentation, path) {
   let segments;
   try {
     segments = splitOpfPath(path);
@@ -67,7 +57,7 @@ export function listPayloadAt(document, path) {
     const next = segments[index + 1];
     if (next !== undefined && !/^\d+$/.test(next)) continue;
     const payloadPath = segments.slice(0, index);
-    const payload = payloadPath.length ? getValueAtPath(document, payloadPath) : document;
+    const payload = payloadPath.length ? getValueAtPath(presentation, payloadPath) : presentation;
     if (!isObject(payload) || !Array.isArray(payload[segments[index]])) continue;
     const entry = next === undefined ? undefined : Number(next);
     return { payloadPath: payloadPath.join("."), field: segments[index], path: [...payloadPath, segments[index]].join("."), payload, entry };
@@ -78,8 +68,8 @@ export function listPayloadAt(document, path) {
 const isRegionKey = (key) => /^(?:(?:top|middle|bottom)(?:\+(?:top|middle|bottom))*(?::(?:left|center|right)(?:\+(?:left|center|right))*)?|(?:left|center|right)(?:\+(?:left|center|right))*)$/.test(key);
 
 /** Every list (`items` or `bullets`) of a slide: its path, label, entry count and whether it is numbered. */
-export function findNumberableLists(document, slideIndex) {
-  const slide = document?.slides?.[slideIndex];
+export function findNumberableLists(presentation, slideIndex) {
+  const slide = presentation?.slides?.[slideIndex];
   if (!isObject(slide)) return [];
   const found = [];
   const visit = (payload, base, label, depth = 0) => {
@@ -137,8 +127,8 @@ const maxLevelOf = (items) => items.reduce((max, item) => Math.max(max, isObject
  * numbering applies to every level), the number of levels the list uses, the markers it draws and which entry (if any)
  * the path selects with that entry's own `start`.
  */
-export function numberingState(document, path) {
-  const target = listPayloadAt(document, path);
+export function numberingState(presentation, path) {
+  const target = listPayloadAt(presentation, path);
   if (!target) return undefined;
   const { payload, field, entry } = target;
   const items = payload[field];
@@ -147,9 +137,9 @@ export function numberingState(document, path) {
   const levels = numbered ? resolveLevels(numbering) : [{ ...DEFAULT_LEVEL }];
   const depth = Math.min(MAX_NUMBERING_LEVELS, maxLevelOf(items) + 1);
   let markers = [];
-  if (numbered && numberingAvailable()) {
+  if (numbered) {
     try {
-      markers = core.listNumbers(items, numbering).map((number) => ({ index: number.index, level: number.level, text: number.text, value: number.value, adapted: number.adapted }));
+      markers = listNumbers(items, numbering).map((number) => ({ index: number.index, level: number.level, text: number.text, value: number.value, adapted: number.adapted }));
     } catch {
       markers = [];
     }
@@ -180,14 +170,13 @@ function numberingPointer(target) {
  * the entry `start` values, which mean nothing without it. `path` addresses the list or anything inside it.
  */
 export function setNumbering(editor, path, value, meta = {}) {
-  requireCore();
   checkEditor(editor);
-  const target = listPayloadAt(editor.document, path);
+  const target = listPayloadAt(editor.presentation, path);
   if (!target) throw fail("not-a-list", "Select a list (items or bullets) to number.", { path });
   const patches = [];
   const present = Object.hasOwn(target.payload, "numbering");
   if (value === undefined || value === null) {
-    if (!present) return { document: editor.document, patches: [], inversePatches: [], validation: editor.validation };
+    if (!present) return { presentation: editor.presentation, patches: [], inversePatches: [], validation: editor.validation };
     patches.push({ op: "remove", path: numberingPointer(target) });
     target.payload[target.field].forEach((item, index) => {
       if (isObject(item) && item.start !== undefined) patches.push({ op: "remove", path: opfPathToJsonPointer(`${target.path}.${index}.start`) });
@@ -203,9 +192,8 @@ export function setNumbering(editor, path, value, meta = {}) {
  * removes the restart. A plain entry (a string or runs) becomes the object form to carry it. One undoable validated edit.
  */
 export function setEntryStart(editor, itemPath, start, meta = {}) {
-  requireCore();
   checkEditor(editor);
-  const target = listPayloadAt(editor.document, itemPath);
+  const target = listPayloadAt(editor.presentation, itemPath);
   if (!target || target.entry === undefined) throw fail("not-an-entry", "Select a list entry to restart its numbering.", { path: itemPath });
   if (target.payload.numbering === undefined) throw fail("not-numbered", "Number the list first; an entry start has no effect on a bulleted list.", { path: itemPath });
   const item = target.payload[target.field][target.entry];
@@ -218,6 +206,6 @@ export function setEntryStart(editor, itemPath, start, meta = {}) {
     if (isObject(item)) patches.push({ op: item.start === undefined ? "add" : "replace", path: `${pointer}/start`, value: start });
     else patches.push({ op: "replace", path: pointer, value: { text: structuredClone(item), start } });
   }
-  if (!patches.length) return { document: editor.document, patches: [], inversePatches: [], validation: editor.validation };
+  if (!patches.length) return { presentation: editor.presentation, patches: [], inversePatches: [], validation: editor.validation };
   return editor.applyPatch(patches, { source: "list-numbering-start", rejectInvalid: true, ...meta });
 }

package/dist/outline-view.js

@@ -92,9 +92,9 @@ export function createOutlineView(container, options) {
     const firstDraw = !lastSnapshot;
     if (snapshot === lastSnapshot && !pendingFocus) return;
     lastSnapshot = snapshot;
-    const document = editor.document;
-    rows = readOutline(document).rows;
-    const sections = hasSections(document);
+    const presentation = editor.presentation;
+    rows = readOutline(presentation).rows;
+    const sections = hasSections(presentation);
     const entries = [];
     let lastSection;
     for (const row of rows) {
@@ -143,18 +143,18 @@ export function createOutlineView(container, options) {
   function activeRow() { return activeKey ? rowByKey(activeKey) : undefined; }
   function updateTools() {
     const row = activeRow();
-    const document = editor.document;
+    const presentation = editor.presentation;
     const can = { promote: false, demote: false, up: false, down: false, add: Boolean(row) };
     if (row) {
       try {
         if (row.kind === "item") {
-          can.demote = prepareShiftOutlineItem(document, row, 1).changed;
-          can.promote = row.level > 1 ? prepareShiftOutlineItem(document, row, -1).changed : row.editable;
-          can.up = prepareMoveOutlineItem(document, row, -1).changed;
-          can.down = prepareMoveOutlineItem(document, row, 1).changed;
+          can.demote = prepareShiftOutlineItem(presentation, row, 1).changed;
+          can.promote = row.level > 1 ? prepareShiftOutlineItem(presentation, row, -1).changed : row.editable;
+          can.up = prepareMoveOutlineItem(presentation, row, -1).changed;
+          can.down = prepareMoveOutlineItem(presentation, row, 1).changed;
         } else if (row.kind === "slide") {
           can.up = row.slideIndex > 0;
-          can.down = row.slideIndex < document.slides.length - 1;
+          can.down = row.slideIndex < presentation.slides.length - 1;
           can.demote = row.slideIndex > 0;
         }
       } catch { /* a row that vanished mid-edit leaves the tools off */ }
@@ -167,7 +167,7 @@ export function createOutlineView(container, options) {
     if (!row?.editable) return false;
     if (input.value === row.text) return false;
     try {
-      const prepared = prepareSetOutlineText(editor.document, row, input.value);
+      const prepared = prepareSetOutlineText(editor.presentation, row, input.value);
       if (!prepared.changed) return false;
       applyOutlineChange(editor, prepared);
       render();
@@ -203,25 +203,25 @@ export function createOutlineView(container, options) {
     const key = activeKey;
     const row = settle(input ?? inputFor(key), key);
     if (!row) return;
-    const document = editor.document;
+    const presentation = editor.presentation;
     if (action === "add") {
-      if (row.kind === "item") apply(() => prepareInsertOutlineItem(document, row), "Line added");
-      else if (row.kind === "slide") apply(() => prepareAddOutlineBullet(document, row.slideIndex), "Bullet added under the slide title");
+      if (row.kind === "item") apply(() => prepareInsertOutlineItem(presentation, row), "Line added");
+      else if (row.kind === "slide") apply(() => prepareAddOutlineBullet(presentation, row.slideIndex), "Bullet added under the slide title");
       else announce("Add a line from a title or a bullet");
     } else if (action === "demote") {
-      if (row.kind === "item") apply(() => prepareShiftOutlineItem(document, row, 1), () => "Demoted");
-      else if (row.kind === "slide") apply(() => prepareOutlineDemoteSlide(document, row.slideIndex), "Slide joined the slide before it as a bullet");
+      if (row.kind === "item") apply(() => prepareShiftOutlineItem(presentation, row, 1), () => "Demoted");
+      else if (row.kind === "slide") apply(() => prepareOutlineDemoteSlide(presentation, row.slideIndex), "Slide joined the slide before it as a bullet");
       else announce("Only titles and bullets change level");
     } else if (action === "promote") {
       if (row.kind === "item") {
-        if (row.level > 1) apply(() => prepareShiftOutlineItem(document, row, -1), "Promoted");
-        else apply(() => prepareOutlinePromote(document, row), (prepared) => `Promoted to slide ${prepared.newSlideIndex + 1}`);
+        if (row.level > 1) apply(() => prepareShiftOutlineItem(presentation, row, -1), "Promoted");
+        else apply(() => prepareOutlinePromote(presentation, row), (prepared) => `Promoted to slide ${prepared.newSlideIndex + 1}`);
       } else if (row.kind === "slide") announce("Slide titles are already the top level");
       else announce("Only titles and bullets change level");
     } else if (action === "up" || action === "down") {
       const delta = action === "up" ? -1 : 1;
-      if (row.kind === "item") apply(() => prepareMoveOutlineItem(document, row, delta), `Moved ${action}`);
-      else if (row.kind === "slide") apply(() => prepareMoveOutlineSlide(document, row.slideIndex, delta), (prepared) => `Slide moved to position ${prepared.selection[0] + 1} of ${document.slides.length}`);
+      if (row.kind === "item") apply(() => prepareMoveOutlineItem(presentation, row, delta), `Moved ${action}`);
+      else if (row.kind === "slide") apply(() => prepareMoveOutlineSlide(presentation, row.slideIndex, delta), (prepared) => `Slide moved to position ${prepared.selection[0] + 1} of ${presentation.slides.length}`);
       else announce("Move bullets or slides");
     }
   }
@@ -244,18 +244,18 @@ export function createOutlineView(container, options) {
       event.preventDefault();
       const settled = settle(input, key);
       if (!settled) return;
-      const document = editor.document;
-      if (settled.kind === "item") apply(() => prepareInsertOutlineItem(document, settled), "Line added");
-      else if (settled.kind === "slide") apply(() => prepareInsertOutlineSlide(document, settled.slideIndex), (prepared) => `Slide ${prepared.index + 1} added`);
+      const presentation = editor.presentation;
+      if (settled.kind === "item") apply(() => prepareInsertOutlineItem(presentation, settled), "Line added");
+      else if (settled.kind === "slide") apply(() => prepareInsertOutlineSlide(presentation, settled.slideIndex), (prepared) => `Slide ${prepared.index + 1} added`);
       else focusAt(index + 1);
       return;
     }
     if (event.key === "Backspace" && input.value === "" && input.selectionStart === 0 && !input.readOnly) {
-      if (row.kind === "item") { event.preventDefault(); apply(() => prepareRemoveOutlineItem(editor.document, row), "Line removed"); }
+      if (row.kind === "item") { event.preventDefault(); apply(() => prepareRemoveOutlineItem(editor.presentation, row), "Line removed"); }
       else if (row.kind === "slide" && !rows.some((other) => other.slideIndex === row.slideIndex && other.kind !== "slide")) {
         event.preventDefault();
         apply(() => {
-          const prepared = prepareRemoveSlides(editor.document, [row.slideIndex]);
+          const prepared = prepareRemoveSlides(editor.presentation, [row.slideIndex]);
           return { ...prepared, focus: `slide:slides.${Math.max(0, row.slideIndex - 1)}` };
         }, `Slide ${row.slideIndex + 1} removed`);
       }

package/dist/outline.d.ts

@@ -35,22 +35,22 @@ export interface PreparedOutlineChange extends Omit<PreparedSlideChange, "select
   reason?: string;
   newSlideIndex?: number;
 }
-export type OutlineChange = Omit<EditorChange, "document" | "patches"> & Omit<PreparedOutlineChange, "document" | "patches"> & { document: unknown; patches: JsonPatchOperation[] };
+export type OutlineChange = Omit<EditorChange, "presentation" | "patches"> & Omit<PreparedOutlineChange, "presentation" | "patches"> & { presentation: unknown; patches: JsonPatchOperation[] };
 
-export declare function readOutline(document: unknown): Outline;
-export declare function prepareSetOutlineText(document: unknown, row: OutlineRow, text: string): PreparedOutlineChange;
+export declare function readOutline(presentation: unknown): Outline;
+export declare function prepareSetOutlineText(presentation: unknown, row: OutlineRow, text: string): PreparedOutlineChange;
 export declare function setOutlineText(editor: EditorSession, row: OutlineRow, text: string, meta?: Record<string, unknown>): OutlineChange;
 /** Nest (`delta` 1) or un-nest (-1) a list item with the items under it. A top-level item reports `changed: false` and a `reason`. */
-export declare function prepareShiftOutlineItem(document: unknown, row: OutlineRow, delta: 1 | -1): PreparedOutlineChange;
-export declare function prepareMoveOutlineItem(document: unknown, row: OutlineRow, delta: 1 | -1): PreparedOutlineChange;
-export declare function prepareInsertOutlineItem(document: unknown, row: OutlineRow, text?: string): PreparedOutlineChange;
-export declare function prepareAddOutlineBullet(document: unknown, slideIndex: number, text?: string): PreparedOutlineChange;
-export declare function prepareRemoveOutlineItem(document: unknown, row: OutlineRow): PreparedOutlineChange;
+export declare function prepareShiftOutlineItem(presentation: unknown, row: OutlineRow, delta: 1 | -1): PreparedOutlineChange;
+export declare function prepareMoveOutlineItem(presentation: unknown, row: OutlineRow, delta: 1 | -1): PreparedOutlineChange;
+export declare function prepareInsertOutlineItem(presentation: unknown, row: OutlineRow, text?: string): PreparedOutlineChange;
+export declare function prepareAddOutlineBullet(presentation: unknown, slideIndex: number, text?: string): PreparedOutlineChange;
+export declare function prepareRemoveOutlineItem(presentation: unknown, row: OutlineRow): PreparedOutlineChange;
 /** A top-level list item becomes the title of a new slide that takes the items after it. */
-export declare function prepareOutlinePromote(document: unknown, row: OutlineRow): PreparedOutlineChange;
+export declare function prepareOutlinePromote(presentation: unknown, row: OutlineRow): PreparedOutlineChange;
 /** A plain slide becomes a bullet (with its text nested) of the slide before it. Throws `outline-row-not-supported` rather than dropping content. */
-export declare function prepareOutlineDemoteSlide(document: unknown, slideIndex: number): PreparedOutlineChange;
-export declare function prepareMoveOutlineSlide(document: unknown, slideIndex: number, delta: number): PreparedOutlineChange;
-export declare function prepareInsertOutlineSlide(document: unknown, slideIndex: number): PreparedOutlineChange;
+export declare function prepareOutlineDemoteSlide(presentation: unknown, slideIndex: number): PreparedOutlineChange;
+export declare function prepareMoveOutlineSlide(presentation: unknown, slideIndex: number, delta: number): PreparedOutlineChange;
+export declare function prepareInsertOutlineSlide(presentation: unknown, slideIndex: number): PreparedOutlineChange;
 /** Apply any prepared outline change as one undoable step. */
 export declare function applyOutlineChange(editor: EditorSession, prepared: PreparedOutlineChange | PreparedSlideChange, meta?: Record<string, unknown>): OutlineChange;