@openpresentation/opf 0.26.10 → 0.28.0

package/dist/examples.d.ts

@@ -1,4 +1,4 @@
-import { P as Presentation } from './presentation-Bwo8Ko6D.js';
+import { Presentation } from './index.js';
 
 interface ExampleRecord {
     /** Filename slug, without the `.opf.json` suffix. */
@@ -40,4 +40,5 @@ declare function getExamplesByGallery(slug: string): readonly ExampleRecord[];
 /** All examples that belong to a given top-level category (`gallery`, `technical`, …). */
 declare function getExamplesByCategory(category: string): readonly ExampleRecord[];
 
-export { type ExampleRecord, type GalleryRecord, exampleCategories, examples, galleries, getExample, getExamplesByCategory, getExamplesByGallery, getGallery };
+export { exampleCategories, examples, galleries, getExample, getExamplesByCategory, getExamplesByGallery, getGallery };
+export type { ExampleRecord, GalleryRecord };

package/dist/examples.js

@@ -1,3 +1,5 @@
+import './chunk-GM7WFPGG.js';
+
 // src/generated/examples.ts
 var examplesData = Object.freeze([
   {
@@ -1047,7 +1049,7 @@ var examplesData = Object.freeze([
             },
             "image": {
               "name": "Image",
-              "summary": "One picture edge to edge under an optional title.",
+              "summary": "One picture, shown whole, under an optional title.",
               "tags": [
                 "Visuals"
               ],
@@ -1067,7 +1069,7 @@ var examplesData = Object.freeze([
                   "bleed": true
                 }
               ],
-              "description": "Let one image carry the message. Add a short title or caption to explain what the audience should notice.",
+              "description": "Let one picture carry the message, shown whole at its own proportions rather than cropped. Add a short title or caption to explain what the audience should notice. For a full-bleed crop, set the image block's fit to cover.",
               "preview": {
                 "vectorSrc": "https://www.pptx.gallery/layout-previews/image.svg"
               },
@@ -3062,7 +3064,8 @@ var examplesData = Object.freeze([
                         "video"
                       ],
                       "role": "media",
-                      "flow": "none"
+                      "flow": "none",
+                      "anchor": "middle"
                     },
                     {
                       "name": "body",
@@ -5080,7 +5083,7 @@ var examplesData = Object.freeze([
             },
             "image": {
               "name": "Image",
-              "summary": "One picture edge to edge under an optional title.",
+              "summary": "One picture, shown whole, under an optional title.",
               "tags": [
                 "Visuals"
               ],
@@ -5100,7 +5103,7 @@ var examplesData = Object.freeze([
                   "bleed": true
                 }
               ],
-              "description": "Let one image carry the message. Add a short title or caption to explain what the audience should notice.",
+              "description": "Let one picture carry the message, shown whole at its own proportions rather than cropped. Add a short title or caption to explain what the audience should notice. For a full-bleed crop, set the image block's fit to cover.",
               "preview": {
                 "vectorSrc": "https://www.pptx.gallery/layout-previews/image.svg"
               },
@@ -6771,7 +6774,7 @@ var examplesData = Object.freeze([
             },
             "image": {
               "name": "Image",
-              "summary": "One picture edge to edge under an optional title.",
+              "summary": "One picture, shown whole, under an optional title.",
               "tags": [
                 "Visuals"
               ],
@@ -6791,7 +6794,7 @@ var examplesData = Object.freeze([
                   "bleed": true
                 }
               ],
-              "description": "Let one image carry the message. Add a short title or caption to explain what the audience should notice.",
+              "description": "Let one picture carry the message, shown whole at its own proportions rather than cropped. Add a short title or caption to explain what the audience should notice. For a full-bleed crop, set the image block's fit to cover.",
               "preview": {
                 "vectorSrc": "https://www.pptx.gallery/layout-previews/image.svg"
               },
@@ -11033,7 +11036,8 @@ var examplesData = Object.freeze([
                         "video"
                       ],
                       "role": "media",
-                      "flow": "none"
+                      "flow": "none",
+                      "anchor": "middle"
                     },
                     {
                       "name": "body",
@@ -14336,7 +14340,8 @@ var examplesData = Object.freeze([
                         "video"
                       ],
                       "role": "media",
-                      "flow": "none"
+                      "flow": "none",
+                      "anchor": "middle"
                     },
                     {
                       "name": "body",
@@ -15481,7 +15486,8 @@ var examplesData = Object.freeze([
                         "video"
                       ],
                       "role": "media",
-                      "flow": "none"
+                      "flow": "none",
+                      "anchor": "middle"
                     },
                     {
                       "name": "body",
@@ -18585,7 +18591,8 @@ var examplesData = Object.freeze([
                         "video"
                       ],
                       "role": "media",
-                      "flow": "none"
+                      "flow": "none",
+                      "anchor": "middle"
                     },
                     {
                       "name": "body",
@@ -20667,7 +20674,8 @@ var examplesData = Object.freeze([
                         "video"
                       ],
                       "role": "media",
-                      "flow": "none"
+                      "flow": "none",
+                      "anchor": "middle"
                     },
                     {
                       "name": "body",
@@ -21826,7 +21834,7 @@ var examplesData = Object.freeze([
             },
             "image": {
               "name": "Image",
-              "summary": "One picture edge to edge under an optional title.",
+              "summary": "One picture, shown whole, under an optional title.",
               "tags": [
                 "Visuals"
               ],
@@ -21846,7 +21854,7 @@ var examplesData = Object.freeze([
                   "bleed": true
                 }
               ],
-              "description": "Let one image carry the message. Add a short title or caption to explain what the audience should notice.",
+              "description": "Let one picture carry the message, shown whole at its own proportions rather than cropped. Add a short title or caption to explain what the audience should notice. For a full-bleed crop, set the image block's fit to cover.",
               "preview": {
                 "vectorSrc": "https://www.pptx.gallery/layout-previews/image.svg"
               },
@@ -24683,7 +24691,7 @@ var examplesData = Object.freeze([
             },
             "image": {
               "name": "Image",
-              "summary": "One picture edge to edge under an optional title.",
+              "summary": "One picture, shown whole, under an optional title.",
               "tags": [
                 "Visuals"
               ],
@@ -24703,7 +24711,7 @@ var examplesData = Object.freeze([
                   "bleed": true
                 }
               ],
-              "description": "Let one image carry the message. Add a short title or caption to explain what the audience should notice.",
+              "description": "Let one picture carry the message, shown whole at its own proportions rather than cropped. Add a short title or caption to explain what the audience should notice. For a full-bleed crop, set the image block's fit to cover.",
               "preview": {
                 "vectorSrc": "https://www.pptx.gallery/layout-previews/image.svg"
               },
@@ -25842,7 +25850,8 @@ var examplesData = Object.freeze([
                         "video"
                       ],
                       "role": "media",
-                      "flow": "none"
+                      "flow": "none",
+                      "anchor": "middle"
                     },
                     {
                       "name": "body",
@@ -26984,7 +26993,8 @@ var examplesData = Object.freeze([
                         "video"
                       ],
                       "role": "media",
-                      "flow": "none"
+                      "flow": "none",
+                      "anchor": "middle"
                     },
                     {
                       "name": "body",
@@ -28119,7 +28129,7 @@ var examplesData = Object.freeze([
             },
             "image": {
               "name": "Image",
-              "summary": "One picture edge to edge under an optional title.",
+              "summary": "One picture, shown whole, under an optional title.",
               "tags": [
                 "Visuals"
               ],
@@ -28139,7 +28149,7 @@ var examplesData = Object.freeze([
                   "bleed": true
                 }
               ],
-              "description": "Let one image carry the message. Add a short title or caption to explain what the audience should notice.",
+              "description": "Let one picture carry the message, shown whole at its own proportions rather than cropped. Add a short title or caption to explain what the audience should notice. For a full-bleed crop, set the image block's fit to cover.",
               "preview": {
                 "vectorSrc": "https://www.pptx.gallery/layout-previews/image.svg"
               },
@@ -32757,7 +32767,7 @@ var examplesData = Object.freeze([
             },
             "image": {
               "name": "Image",
-              "summary": "One picture edge to edge under an optional title.",
+              "summary": "One picture, shown whole, under an optional title.",
               "tags": [
                 "Visuals"
               ],
@@ -32777,7 +32787,7 @@ var examplesData = Object.freeze([
                   "bleed": true
                 }
               ],
-              "description": "Let one image carry the message. Add a short title or caption to explain what the audience should notice.",
+              "description": "Let one picture carry the message, shown whole at its own proportions rather than cropped. Add a short title or caption to explain what the audience should notice. For a full-bleed crop, set the image block's fit to cover.",
               "preview": {
                 "vectorSrc": "https://www.pptx.gallery/layout-previews/image.svg"
               },
@@ -34798,7 +34808,8 @@ var examplesData = Object.freeze([
                         "video"
                       ],
                       "role": "media",
-                      "flow": "none"
+                      "flow": "none",
+                      "anchor": "middle"
                     },
                     {
                       "name": "body",
@@ -36529,7 +36540,8 @@ var examplesData = Object.freeze([
                         "video"
                       ],
                       "role": "media",
-                      "flow": "none"
+                      "flow": "none",
+                      "anchor": "middle"
                     },
                     {
                       "name": "body",
@@ -41933,7 +41945,7 @@ var examplesData = Object.freeze([
             },
             "image": {
               "name": "Image",
-              "summary": "One picture edge to edge under an optional title.",
+              "summary": "One picture, shown whole, under an optional title.",
               "tags": [
                 "Visuals"
               ],
@@ -41953,7 +41965,7 @@ var examplesData = Object.freeze([
                   "bleed": true
                 }
               ],
-              "description": "Let one image carry the message. Add a short title or caption to explain what the audience should notice.",
+              "description": "Let one picture carry the message, shown whole at its own proportions rather than cropped. Add a short title or caption to explain what the audience should notice. For a full-bleed crop, set the image block's fit to cover.",
               "preview": {
                 "vectorSrc": "https://www.pptx.gallery/layout-previews/image.svg"
               },
@@ -43095,7 +43107,8 @@ var examplesData = Object.freeze([
                         "video"
                       ],
                       "role": "media",
-                      "flow": "none"
+                      "flow": "none",
+                      "anchor": "middle"
                     },
                     {
                       "name": "body",
@@ -46173,7 +46186,7 @@ var examplesData = Object.freeze([
             },
             "image": {
               "name": "Image",
-              "summary": "One picture edge to edge under an optional title.",
+              "summary": "One picture, shown whole, under an optional title.",
               "tags": [
                 "Visuals"
               ],
@@ -46193,7 +46206,7 @@ var examplesData = Object.freeze([
                   "bleed": true
                 }
               ],
-              "description": "Let one image carry the message. Add a short title or caption to explain what the audience should notice.",
+              "description": "Let one picture carry the message, shown whole at its own proportions rather than cropped. Add a short title or caption to explain what the audience should notice. For a full-bleed crop, set the image block's fit to cover.",
               "preview": {
                 "vectorSrc": "https://www.pptx.gallery/layout-previews/image.svg"
               },
@@ -49080,7 +49093,7 @@ var examplesData = Object.freeze([
             },
             "image": {
               "name": "Image",
-              "summary": "One picture edge to edge under an optional title.",
+              "summary": "One picture, shown whole, under an optional title.",
               "tags": [
                 "Visuals"
               ],
@@ -49100,7 +49113,7 @@ var examplesData = Object.freeze([
                   "bleed": true
                 }
               ],
-              "description": "Let one image carry the message. Add a short title or caption to explain what the audience should notice.",
+              "description": "Let one picture carry the message, shown whole at its own proportions rather than cropped. Add a short title or caption to explain what the audience should notice. For a full-bleed crop, set the image block's fit to cover.",
               "preview": {
                 "vectorSrc": "https://www.pptx.gallery/layout-previews/image.svg"
               },
@@ -52269,7 +52282,8 @@ var examplesData = Object.freeze([
                         "video"
                       ],
                       "role": "media",
-                      "flow": "none"
+                      "flow": "none",
+                      "anchor": "middle"
                     },
                     {
                       "name": "body",
@@ -54312,7 +54326,8 @@ var examplesData = Object.freeze([
                         "video"
                       ],
                       "role": "media",
-                      "flow": "none"
+                      "flow": "none",
+                      "anchor": "middle"
                     },
                     {
                       "name": "body",
@@ -55440,7 +55455,7 @@ var examplesData = Object.freeze([
             },
             "image": {
               "name": "Image",
-              "summary": "One picture edge to edge under an optional title.",
+              "summary": "One picture, shown whole, under an optional title.",
               "tags": [
                 "Visuals"
               ],
@@ -55460,7 +55475,7 @@ var examplesData = Object.freeze([
                   "bleed": true
                 }
               ],
-              "description": "Let one image carry the message. Add a short title or caption to explain what the audience should notice.",
+              "description": "Let one picture carry the message, shown whole at its own proportions rather than cropped. Add a short title or caption to explain what the audience should notice. For a full-bleed crop, set the image block's fit to cover.",
               "preview": {
                 "vectorSrc": "https://www.pptx.gallery/layout-previews/image.svg"
               },
@@ -56625,7 +56640,8 @@ var examplesData = Object.freeze([
                         "video"
                       ],
                       "role": "media",
-                      "flow": "none"
+                      "flow": "none",
+                      "anchor": "middle"
                     },
                     {
                       "name": "body",
@@ -57735,7 +57751,7 @@ var examplesData = Object.freeze([
             },
             "image": {
               "name": "Image",
-              "summary": "One picture edge to edge under an optional title.",
+              "summary": "One picture, shown whole, under an optional title.",
               "tags": [
                 "Visuals"
               ],
@@ -57755,7 +57771,7 @@ var examplesData = Object.freeze([
                   "bleed": true
                 }
               ],
-              "description": "Let one image carry the message. Add a short title or caption to explain what the audience should notice.",
+              "description": "Let one picture carry the message, shown whole at its own proportions rather than cropped. Add a short title or caption to explain what the audience should notice. For a full-bleed crop, set the image block's fit to cover.",
               "preview": {
                 "vectorSrc": "https://www.pptx.gallery/layout-previews/image.svg"
               },
@@ -59504,7 +59520,7 @@ var examplesData = Object.freeze([
             },
             "image": {
               "name": "Image",
-              "summary": "One picture edge to edge under an optional title.",
+              "summary": "One picture, shown whole, under an optional title.",
               "tags": [
                 "Visuals"
               ],
@@ -59524,7 +59540,7 @@ var examplesData = Object.freeze([
                   "bleed": true
                 }
               ],
-              "description": "Let one image carry the message. Add a short title or caption to explain what the audience should notice.",
+              "description": "Let one picture carry the message, shown whole at its own proportions rather than cropped. Add a short title or caption to explain what the audience should notice. For a full-bleed crop, set the image block's fit to cover.",
               "preview": {
                 "vectorSrc": "https://www.pptx.gallery/layout-previews/image.svg"
               },
@@ -60626,7 +60642,7 @@ var examplesData = Object.freeze([
             },
             "image": {
               "name": "Image",
-              "summary": "One picture edge to edge under an optional title.",
+              "summary": "One picture, shown whole, under an optional title.",
               "tags": [
                 "Visuals"
               ],
@@ -60646,7 +60662,7 @@ var examplesData = Object.freeze([
                   "bleed": true
                 }
               ],
-              "description": "Let one image carry the message. Add a short title or caption to explain what the audience should notice.",
+              "description": "Let one picture carry the message, shown whole at its own proportions rather than cropped. Add a short title or caption to explain what the audience should notice. For a full-bleed crop, set the image block's fit to cover.",
               "preview": {
                 "vectorSrc": "https://www.pptx.gallery/layout-previews/image.svg"
               },
@@ -63785,7 +63801,8 @@ var examplesData = Object.freeze([
                         "video"
                       ],
                       "role": "media",
-                      "flow": "none"
+                      "flow": "none",
+                      "anchor": "middle"
                     },
                     {
                       "name": "body",
@@ -69580,7 +69597,8 @@ var examplesData = Object.freeze([
                         "video"
                       ],
                       "role": "media",
-                      "flow": "none"
+                      "flow": "none",
+                      "anchor": "middle"
                     },
                     {
                       "name": "body",
@@ -76007,7 +76025,8 @@ var examplesData = Object.freeze([
                         "video"
                       ],
                       "role": "media",
-                      "flow": "none"
+                      "flow": "none",
+                      "anchor": "middle"
                     },
                     {
                       "name": "body",
@@ -78953,7 +78972,8 @@ var examplesData = Object.freeze([
                         "video"
                       ],
                       "role": "media",
-                      "flow": "none"
+                      "flow": "none",
+                      "anchor": "middle"
                     },
                     {
                       "name": "body",
@@ -87373,7 +87393,7 @@ var examplesData = Object.freeze([
             },
             "image": {
               "name": "Image",
-              "summary": "One picture edge to edge under an optional title.",
+              "summary": "One picture, shown whole, under an optional title.",
               "tags": [
                 "Visuals"
               ],
@@ -87393,7 +87413,7 @@ var examplesData = Object.freeze([
                   "bleed": true
                 }
               ],
-              "description": "Let one image carry the message. Add a short title or caption to explain what the audience should notice.",
+              "description": "Let one picture carry the message, shown whole at its own proportions rather than cropped. Add a short title or caption to explain what the audience should notice. For a full-bleed crop, set the image block's fit to cover.",
               "preview": {
                 "vectorSrc": "https://www.pptx.gallery/layout-previews/image.svg"
               },
@@ -89026,7 +89046,8 @@ var examplesData = Object.freeze([
                         "video"
                       ],
                       "role": "media",
-                      "flow": "none"
+                      "flow": "none",
+                      "anchor": "middle"
                     },
                     {
                       "name": "body",
@@ -91266,7 +91287,8 @@ var examplesData = Object.freeze([
                         "video"
                       ],
                       "role": "media",
-                      "flow": "none"
+                      "flow": "none",
+                      "anchor": "middle"
                     },
                     {
                       "name": "body",
@@ -95114,6 +95136,26 @@ var examplesData = Object.freeze([
               }
             }
           ]
+        },
+        {
+          "title": "No-Bullet Label Lists Override",
+          "design": {
+            "listBullet": "none"
+          },
+          "items": [
+            {
+              "text": "Clear scope",
+              "description": "Two teams and one workflow keep the pilot focused."
+            },
+            {
+              "text": "Consistent measures",
+              "description": "Track completion and task time against a baseline."
+            },
+            {
+              "text": "An explicit decision",
+              "description": "Agree the evidence needed before expanding."
+            }
+          ]
         }
       ],
       "assets": {

package/dist/{explain-JSuESV-Y.d.ts → explain-iZeNOUc6.d.ts}

@@ -68,4 +68,5 @@ interface RuleExplanation {
  */
 declare function explain(ruleId: string): RuleExplanation | undefined;
 
-export { type FindingTextContext as F, type RuleExplanation as R, type FindingText as a, distance as d, explain as e, nearest as n, segmentsOf as s };
+export { distance as d, explain as e, nearest as n, segmentsOf as s };
+export type { FindingTextContext as F, RuleExplanation as R, FindingText as a };

package/dist/font-policy.d.ts

@@ -139,4 +139,5 @@ interface FontAvailabilityDiagnostic {
  */
 declare function fontAvailabilityDiagnostics(families: Iterable<string>): FontAvailabilityDiagnostic[];
 
-export { FONT_POLICY, type FontAvailability, type FontAvailabilityCode, type FontAvailabilityDiagnostic, type FontLicenseClass, type FontPolicyDecision, type FontPolicyEntry, type FontPolicyTable, type FontReplacement, type FontReplacementCompatibility, type FontReplacementMeasurement, applyFontPolicyDecisions, fontAvailabilityDiagnostics, fontPolicyFor };
+export { FONT_POLICY, applyFontPolicyDecisions, fontAvailabilityDiagnostics, fontPolicyFor };
+export type { FontAvailability, FontAvailabilityCode, FontAvailabilityDiagnostic, FontLicenseClass, FontPolicyDecision, FontPolicyEntry, FontPolicyTable, FontReplacement, FontReplacementCompatibility, FontReplacementMeasurement };

package/dist/font-policy.js

@@ -1 +1,2 @@
 export { FONT_POLICY, applyFontPolicyDecisions, fontAvailabilityDiagnostics, fontPolicyFor } from './chunk-PJSPHHRK.js';
+import './chunk-GM7WFPGG.js';

package/dist/format.d.ts

@@ -17,4 +17,5 @@ declare function format(input: unknown, options?: FormatOptions): string;
 /** True when `source` is already exactly the canonical text. */
 declare function isFormatted(source: string, options?: FormatOptions): boolean;
 
-export { type FormatOptions, OPFFormatError, format, isFormatted, sortPresentationKeys };
+export { OPFFormatError, format, isFormatted, sortPresentationKeys };
+export type { FormatOptions };

package/dist/format.js

@@ -1,2 +1,3 @@
-export { OPFFormatError, format, isFormatted, sortPresentationKeys } from './chunk-EQ6S5SEZ.js';
-import './chunk-F4HFDP6I.js';
+export { OPFFormatError, format, isFormatted, sortPresentationKeys } from './chunk-KELC4K62.js';
+import './chunk-5Q4IYLMW.js';
+import './chunk-GM7WFPGG.js';

package/dist/ids.d.ts

@@ -0,0 +1,114 @@
+import { JsonPatchOperation } from './index.js';
+export { OPFPatchHashError, documentHash, idToken, isIdToken, resolveIdPatch, resolveIdPointer, toIdPatch, toIdPointer } from './patch.js';
+
+type IdErrorCode = "invalid-document" | "invalid-id" | "duplicate-id";
+/** Thrown by `assignIds` for a value that is not a document or a `generate` that returns an unusable id. */
+declare class OPFIdError extends Error {
+    readonly code: IdErrorCode;
+    /** The JSON Pointer of the slide or payload the error is about, when known. */
+    path?: string;
+    constructor(code: IdErrorCode, message: string, path?: string);
+}
+interface AssignIdsContext {
+    /** `slide` for an entry of `slides`; `block` for a content payload (a block, a nested group or a promoted region). */
+    kind: "slide" | "block";
+    /** The JSON Pointer of the node, in index form (`/slides/2/blocks/0`). */
+    pointer: string;
+    /** The node, read only. */
+    node: Readonly<Record<string, unknown>>;
+    /** The id of the nearest slide or group above the node that has one (an id assigned earlier in this call counts). */
+    parentId?: string;
+}
+interface AssignIdsOptions {
+    /**
+     * Make the id of a node. It must return a non-empty string no slide or payload of the document uses, or `assignIds` throws
+     * `OPFIdError` (`invalid-id`, `duplicate-id`). It is called in document order and must not depend on anything but its argument if the
+     * result is to be deterministic. The default makes `slide-1`, `slide-2`, ... and `block-1`, `block-2`, ... skipping ids in use.
+     */
+    generate?: (context: AssignIdsContext) => string;
+}
+interface AssignedId {
+    /** The JSON Pointer of the node that got the id, in index form. */
+    pointer: string;
+    kind: "slide" | "block";
+    id: string;
+}
+interface AssignIdsResult {
+    /** A copy of the document in which every slide and payload has an id. */
+    document: unknown;
+    /** The `add` operations that produce `document` from the input: one `/…/id` per assigned id. Empty when nothing was missing. */
+    patch: JsonPatchOperation[];
+    assigned: AssignedId[];
+}
+/**
+ * Give every slide and content payload that has no `id` one, deterministically: the same document and `generate` give the same ids. An
+ * existing id is never changed (not even a duplicate: that is a validation finding, not an assignment), and a new id is never one in
+ * use, so a valid document stays valid. The input is not changed; `patch` is the same change as operations, for an editor to apply as one
+ * undoable edit. The id is added as the node's last member (`format` puts it in canonical order).
+ *
+ * Slides and payloads share one id namespace in the schema; list items, table rows and runs have no id.
+ */
+declare function assignIds(document: unknown, options?: AssignIdsOptions): AssignIdsResult;
+/**
+ * The part of a presentation a location belongs to:
+ * - `document`: the whole document (the root);
+ * - `slide-order`: the `slides` array, or a slide as a whole (added, removed, moved, copied);
+ * - `slide`: a field of one slide, or a slide replaced or read as a whole;
+ * - `block`: a content payload (a block, a nested group or a promoted region) or the `blocks` array that holds it, below a slide;
+ * - `design`: the deck's `design` or a slide's `design`;
+ * - `assets`, `catalogs`: the deck's `assets` and `catalogs`;
+ * - `metadata`: every other deck field (`name`, `language`, `references`, `datasets`, `variables`, `narrative`, `extensions`, ...).
+ */
+type PatchScopeKind = "document" | "slide-order" | "slide" | "block" | "design" | "assets" | "catalogs" | "metadata";
+/** One location an operation reads or writes. */
+interface PatchTouch {
+    /** The index of the operation within the patch. */
+    operation: number;
+    op: JsonPatchOperation["op"];
+    /**
+     * The JSON Pointer of the location. With a document: in index form, as it is when the operation runs (id tokens resolved, an
+     * `add` at `-` given the index it appended at). Without one: as written.
+     */
+    pointer: string;
+    /** The same location with `@id` tokens wherever an element has an id; without a document, as written. It survives reordering. */
+    idPointer: string;
+    kind: PatchScopeKind;
+    /**
+     * The ids of the slides and payloads this location is inside, is, or contains: every slide and payload on the path, plus the
+     * ones inside the value a write removes, replaces or inserts (removing a slide lists its blocks). Without a document: the ids the
+     * pointer names with id tokens and the ids inside the operation's value.
+     */
+    ids: string[];
+    /** The ids in `ids` that belong to slides. */
+    slideIds: string[];
+}
+interface PatchScope {
+    /** What the patch looks at without changing: `test`, and the source of `copy`. In operation order. */
+    reads: PatchTouch[];
+    /** What the patch changes: `add`, `replace`, `remove`, both ends of `move`, the destination of `copy`. In operation order. */
+    writes: PatchTouch[];
+    /** Every id in `reads` and `writes`, in order of first appearance. */
+    ids: string[];
+    slideIds: string[];
+    /** The kinds of `reads` and `writes`, in the order `PatchScopeKind` lists them. */
+    kinds: PatchScopeKind[];
+}
+/**
+ * What a patch reads and writes, for conflict detection and permission checks.
+ *
+ * Without `document`, from the patch alone: the pointers as written, the id tokens they carry and the ids inside the values the
+ * operations insert. With `document`, the patch is walked operation by operation against that document (the version it was made for),
+ * so each location is resolved as it is when its operation runs: an earlier operation that inserts or moves a slide is accounted for,
+ * `@id` tokens become indexes, every location also gets its id form, and a `remove`, `replace` or `move` lists the ids of what it
+ * destroys. A patch that does not apply to `document` throws the `OPFPatchError` that `applyPatch` throws; the document is not changed.
+ *
+ * Two patches made against the same document conflict when a write of one has the same `idPointer` as, or sits inside or above, a
+ * location the other reads or writes (compare `pointer` when elements have no ids), or when what one destroys is in the `ids` of the
+ * other. A `move` changes where an element sits, not what is inside it, so it meets the element and its siblings but not an edit
+ * inside it: skip the descendants of a `move` location (`op` is `move`). A permission check reads `kind`, `slideIds` and `ids` of
+ * `writes`, moves included. What counts as a conflict and what a user may touch stays with the host.
+ */
+declare function touches(patch: unknown, document?: unknown): PatchScope;
+
+export { OPFIdError, assignIds, touches };
+export type { AssignIdsContext, AssignIdsOptions, AssignIdsResult, AssignedId, IdErrorCode, PatchScope, PatchScopeKind, PatchTouch };