# @embedpdf/plugin-page-edit — ./internal PageDeleteResult [InterfaceDeclaration] (from packages/engine/core/src/mutation/PageDeleteResult.ts): export interface PageDeleteResult{ layout: PageListSnapshot; cache: PageStructureCache | null; } PageEditCapability [InterfaceDeclaration] (from packages/plugin/page-edit/src/contract.ts): export interface PageEditCapability{ canEdit(): boolean; rotateBy( pages: readonly PageRef[], delta: 90 | -90 | 180, options?: OperationOptions, ): Promise; setRotation( pages: readonly PageRef[], rotation: PageRotation, options?: OperationOptions, ): Promise; move( pages: readonly PageRef[], placement: PagePlacement, options?: OperationOptions, ): Promise; delete(pages: readonly PageRef[], options?: OperationOptions): Promise; insertBlank( options?:{ count?: number; size?: PdfSize; placement?: PagePlacement} & OperationOptions, ): Promise; insertFromBytes( bytes: Uint8Array | ArrayBuffer, options?:{ pageIndexes?: readonly number[]; placement?: PagePlacement} & OperationOptions, ): Promise; insertFromDocument( documentId: string, pages: readonly PageRef[], options?:{ placement?: PagePlacement} & OperationOptions, ): Promise; duplicate( pages: readonly PageRef[], options?:{ placement?: PagePlacement} & OperationOptions, ): Promise; extract(pages: readonly PageRef[], options?: OperationOptions): Promise; } PageEditHostCapability [TypeAliasDeclaration] (from packages/plugin/page-edit/src/host-contract.ts): export type PageEditHostCapability = PageEditCapability; PageEditToken [VariableDeclaration] (from packages/plugin/page-edit/src/token.ts): PageEditToken = createCapabilityToken('page-edit', { hint: `add pageEditPlugin() from '@embedpdf/plugin-page-edit' to your plugins list`, } ) PageInsertResult [InterfaceDeclaration] (from packages/engine/core/src/mutation/PageInsertResult.ts): export interface PageInsertResult{ insertedPages: PageRef[]; layout: PageListSnapshot; cache: PageStructureCache | null; } PageMoveResult [InterfaceDeclaration] (from packages/engine/core/src/mutation/PageMoveResult.ts): export interface PageMoveResult{ layout: PageListSnapshot; cache: PageMoveCache | null; } PagePlacement [TypeAliasDeclaration] (from packages/plugin/page-edit/src/contract.ts): export type PagePlacement ={ after: PageRef} |{ before: PageRef} |{ index: number} | 'end'; PageRotateResult [InterfaceDeclaration] (from packages/engine/core/src/mutation/PageRotateResult.ts): export interface PageRotateResult{ layout: PageListSnapshot; cache: PageStructureCache | null; } PageRotation [TypeAliasDeclaration] (from packages/engine/core/src/dto/PageLayout.ts): export type PageRotation = PdfRotation; PdfSize [InterfaceDeclaration] (from packages/engine/core/src/geometry/primitives.ts): export interface PdfSize{ width: number; height: number; } createPageEditController [FunctionDeclaration] (from packages/plugin/page-edit/src/controller.ts): export function createPageEditController(ctx: PluginContext): PageEditCapability{ const enqueue = createSerialQueue(); const requireDoc = (): DocumentHandle =>{ const doc = ctx.doc; if (!doc) throw new PluginError('not-ready', 'page-edit', 'no document bound'); return doc; } ; const engine = async (work: () => Promise): Promise =>{ try{ return await work(); } catch (error){ throw toPluginError('page-edit', error); } } ; const registry = () => ctx.document()?.pages ?? []; const entryOf = (page: PageRef) => registry().find((p) => p.ref.pageObjectNumber === page.pageObjectNumber); const requireEntry = (page: PageRef) =>{ const entry = entryOf(page); if (!entry){ throw new PluginError('not-found', 'page-edit', `no page ${ page.pageObjectNumber} `); } return entry; } ; const resolvePlacement = (placement: PagePlacement | undefined) =>{ if (!placement || placement === 'end') return{ destIndex: undefined, anchor: undefined} ; if ('index' in placement) return{ destIndex: placement.index, anchor: undefined} ; const anchor = requireEntry('after' in placement ? placement.after : placement.before); return{ destIndex: 'after' in placement ? anchor.index + 1 : anchor.index, anchor} ; } ; const neighbourSize = (destIndex: number | undefined): PdfSize =>{ const pages = registry(); if (pages.length === 0) return{ width: 612, height: 792} ; if (destIndex === undefined) return pages[pages.length - 1].size; return pages[Math.max(0, Math.min(destIndex - 1, pages.length - 1))].size; } ; const insertAt = ( doc: DocumentHandle, bytes: Uint8Array | ArrayBuffer, placement: PagePlacement | undefined, ): Promise => engine(() => doc.pages.insert(bytes, resolvePlacement(placement).destIndex)); const api: PageEditCapability ={ canEdit: () => ctx.doc?.security.allows(ASSEMBLE_CAPABILITY) ?? false, rotateBy: (pages, delta) => enqueue(async () =>{ const doc = requireDoc(); const groups = new Map(); for (const page of pages){ const next = ((((requireEntry(page).rotation + delta) % 360) + 360) % 360) as PageRotation; groups.set(next, [...(groups.get(next) ?? []), page]); } let result: PageRotateResult | null = null; for (const [rotation, group] of groups){ result = await engine(() => doc.pages.rotate(group, rotation)); } if (!result) throw new PluginError('invalid-input', 'page-edit', 'no pages given'); return result; } ), setRotation: (pages, rotation) => enqueue(() => engine(() => requireDoc().pages.rotate([...pages], rotation))), move: (pages, placement) => enqueue(() =>{ const doc = requireDoc(); const{ destIndex} = resolvePlacement(placement); return engine(() => doc.pages.move([...pages], destIndex ?? registry().length)); } ), delete: (pages) => enqueue(() => engine(() => requireDoc().pages.delete([...pages]))), insertBlank: (options ={ } ) => enqueue(() =>{ const doc = requireDoc(); const{ destIndex, anchor} = resolvePlacement(options.placement); const size = options.size ?? anchor?.size ?? neighbourSize(destIndex); return engine(() => doc.pages.insertBlank({ size, count: options.count} , destIndex)); } ), insertFromBytes: (bytes, options ={ } ) => enqueue(async () =>{ const doc = requireDoc(); if (!options.pageIndexes) return insertAt(doc, bytes, options.placement); const source = await engine(() => ctx.engine.open({ kind: 'bytes', id: `page-edit-source-${ Date.now().toString(36)} `, bytes: new Uint8Array(bytes), } , { scope: ['*']} , ), ); try{ const layout = await engine(() => source.pages.list()); const refs = options.pageIndexes!.map((index) =>{ const page = layout.pages[index]; if (!page) throw new PluginError('not-found', 'page-edit', `the PDF has no page ${ index} `); return page.ref; } ); const subset = await engine(() => source.pages.extract(refs)); return await insertAt(doc, subset, options.placement); } finally{ await source.close(); } } ), insertFromDocument: (documentId, pages, options ={ } ) => enqueue(async () =>{ const doc = requireDoc(); const other = ctx.documentHandle(documentId); if (!other) throw new PluginError('not-found', 'page-edit', `document '${ documentId} ' is not open`); const bytes = await engine(() => other.pages.extract([...pages])); return insertAt(doc, bytes, options.placement); } ), duplicate: (pages, options ={ } ) => enqueue(async () =>{ const doc = requireDoc(); const last = pages[pages.length - 1]; if (!last) throw new PluginError('invalid-input', 'page-edit', 'no pages given'); const bytes = await engine(() => doc.pages.extract([...pages])); return insertAt(doc, bytes, options.placement ??{ after: last} ); } ), extract: (pages) => engine(() => requireDoc().pages.extract([...pages])), } ; return api; }