@office-kit/pptx 0.16.0 → 0.16.1

package/CHANGELOG.md

@@ -1,4 +1,14 @@
-# pptx-kit
+# @office-kit/pptx
+
+## 0.16.1
+
+### Patch Changes
+
+- b8adc13: Duplicated slides now have independent charts, embedded workbooks and notes.
+  Editing a duplicate no longer changes the original's chart or notes. Unknown
+  owned dependency parts are copied too, including cyclic relationships. Layouts,
+  masters, themes and media remain shared. Invalid missing dependencies fail before
+  parts are added.
 
 ## 0.16.0
 

package/README.md

@@ -28,6 +28,16 @@ const out: Uint8Array = await savePresentation(pres);
 
 ## Why this library
 
+For declarative TSX authoring, use the companion
+[`@office-kit/pptx-dsl`](packages/dsl) and
+[`@office-kit/pptx-dev`](packages/dev) packages. They provide typed elements,
+template editing, a local watch preview and PPTX export, with no React or Vue
+runtime. The dev package initializes a project with VSCode tasks and a
+`CLAUDE.md` authoring guide. Start with the
+[step-by-step authoring guide](https://office-kit.github.io/pptx/docs/authoring):
+the CLI and DSL are not yet published to npm, so it includes a verified
+source-checkout installation.
+
 - **It reads as well as it writes.** Open a deck made in PowerPoint, Keynote,
   or Google Slides, change it, and save it. Every setter has a getter, and
   there are deck-wide queries (find every hyperlink, every comment by an
@@ -319,7 +329,7 @@ setShapeText(findSlidePlaceholder(slide, 'ctrTitle')!, 'Authored with @office-ki
 const out: Uint8Array = await savePresentation(pres);
 ```
 
-### Build a deck from a blank template
+### Add slides to your own template
 
 ```ts
 import {
@@ -336,7 +346,8 @@ import {
   setShapeText,
 } from '@office-kit/pptx';
 
-const pres = await loadPresentation(await fetch('/blank.pptx').then((r) => r.arrayBuffer()));
+// Layout names come from the template; list them with getSlideLayouts(pres).
+const pres = await loadPresentation(await fetch('/template.pptx').then((r) => r.arrayBuffer()));
 
 const titleLayout = findSlideLayout(pres, 'Title Slide')!;
 const slide1 = addSlide(pres, { layout: titleLayout });

package/dist/{api-DQEn2Bo4.js → api-Dt6q_IAv.js}

@@ -8154,8 +8154,9 @@ const validateChartSpecAxes = (spec) => {
 };
 /**
 * Adds a chart to the slide. Returns the new shape handle (kind
-* `graphicFrame`). Supported chart kinds today: `bar`, `column`,
-* `line`, `pie` — see `ChartSpec.kind`.
+* `graphicFrame`). Authorable chart kinds: `bar`, `column`, `line`,
+* `pie`, `doughnut`, `area`. `scatter`, `radar` and `bubble` are read +
+* render only and are rejected here — see `ChartKind`.
 *
 * Side effects:
 *
@@ -16747,6 +16748,80 @@ const setSlideSections = (pres, sections) => {
 	presPart.data = encode$1(serializeXml(doc));
 };
 //#endregion
+//#region src/internal/parts/duplicate-graph.ts
+/** Clone owned dependencies without interpreting their bodies or relationship types. */
+function duplicatePartGraph(pkg, source, destination, sharedTypes) {
+	const parts = new Map(pkg.parts.map((part) => [part.name.toLowerCase(), part]));
+	const occupied = new Set(parts.keys());
+	const copies = new Map([[source.toLowerCase(), destination]]);
+	const pending = [source];
+	const planned = [];
+	const encoder = new TextEncoder();
+	const decoder = new TextDecoder();
+	occupied.add(destination.toLowerCase());
+	const counters = /* @__PURE__ */ new Map();
+	const allocate = (name) => {
+		const dot = name.lastIndexOf(".");
+		const split = dot > name.lastIndexOf("/") ? dot : name.length;
+		const stem = name.slice(0, split);
+		const extension = name.slice(split);
+		let n = counters.get(name.toLowerCase()) ?? 1;
+		let candidate;
+		do
+			candidate = partName(`${stem}-copy${n++}${extension}`);
+		while (occupied.has(candidate.toLowerCase()));
+		counters.set(name.toLowerCase(), n);
+		occupied.add(candidate.toLowerCase());
+		return candidate;
+	};
+	for (let index = 0; index < pending.length; index++) {
+		const name = pending[index];
+		const part = parts.get(name.toLowerCase());
+		if (!part) throw new Error(`Cannot duplicate missing dependency ${name}`);
+		const copy = copies.get(name.toLowerCase());
+		planned.push({
+			name: copy,
+			contentType: part.contentType,
+			data: new Uint8Array(part.data)
+		});
+		const relsPart = parts.get(relsPartNameFor(name).toLowerCase());
+		if (!relsPart) continue;
+		const doc = parseXml(decoder.decode(relsPart.data));
+		for (const element of doc.root.children) {
+			if (element.kind !== "element" || element.name.localName !== "Relationship" || element.name.namespaceURI !== NS.relationships) continue;
+			const target = element.attrs.find((attribute) => attribute.name.namespaceURI === "" && attribute.name.localName === "Target");
+			const type = element.attrs.find((attribute) => attribute.name.namespaceURI === "" && attribute.name.localName === "Type")?.value;
+			const mode = element.attrs.find((attribute) => attribute.name.namespaceURI === "" && attribute.name.localName === "TargetMode")?.value;
+			if (!target || !type) throw new Error(`Invalid relationship in ${relsPart.name}`);
+			if (mode === "External") continue;
+			const resolved = resolveTarget(name, target.value);
+			if (!parts.has(resolved.toLowerCase())) throw new Error(`Cannot duplicate missing dependency ${resolved}`);
+			let mapped = copies.get(resolved.toLowerCase());
+			if (!mapped && !sharedTypes.has(type)) {
+				mapped = allocate(resolved);
+				copies.set(resolved.toLowerCase(), mapped);
+				pending.push(resolved);
+			}
+			element.attrs = element.attrs.map((attribute) => attribute === target ? {
+				...attribute,
+				value: mapped ?? resolved
+			} : attribute);
+		}
+		planned.push({
+			name: relsPartNameFor(copy),
+			contentType: relsPart.contentType,
+			data: encoder.encode(serializeXml(doc))
+		});
+	}
+	const names = new Set(parts.keys());
+	for (const part of planned) {
+		const key = part.name.toLowerCase();
+		if (names.has(key)) throw new Error(`Cannot duplicate into existing part ${part.name}`);
+		names.add(key);
+	}
+	for (const part of planned) pkg.addPart(part.name, part.contentType, part.data);
+}
+//#endregion
 //#region src/api/fn/slide-deck.ts
 const ensureSldIdLst = (presentationRoot) => {
 	const existing = firstChildElement(presentationRoot, NAME_SLD_ID_LST$1);
@@ -17038,25 +17113,33 @@ const moveSlide = (pres, slide, toIndex) => {
 /**
 * Duplicates a slide. Returns the new `SlideData` appended to deck order.
 *
-* Part bytes and rels are cloned verbatim; media parts are NOT copied —
-* the duplicate shares the original's media references (PowerPoint
-* does the same).
+* Charts, embedded workbooks, notes and other owned dependencies are copied.
+* Layouts, masters, themes, media and links to other slides remain shared.
+* Unknown dependency bodies are retained without interpreting their content.
 */
 const duplicateSlide = (pres, slide) => {
 	const pkg = pres[INTERNAL_PACKAGE];
+	if (slide[INTERNAL_PACKAGE] !== pkg) throw new Error("duplicateSlide: slide belongs to another presentation");
 	const sourcePartName = slide[SLIDE_PART_NAME];
-	const sourcePart = pkg.getPart(sourcePartName);
-	if (!sourcePart) throw new Error(`duplicateSlide: source ${sourcePartName} not found`);
+	if (!pkg.getPart(sourcePartName)) throw new Error(`duplicateSlide: source ${sourcePartName} not found`);
 	const presPart = pkg.getPart(PRES_PART_NAME);
 	if (!presPart) throw new Error("presentation.xml missing");
 	const presDoc = parseXml(decode$1(presPart.data));
 	const sldIdLst = ensureSldIdLst(presDoc.root);
 	const newSldId = allocateSldId(sldIdLst);
 	const slideN = allocateSlideN(pkg);
-	const newSlidePartName = partName(`/ppt/slides/slide${slideN}.xml`);
-	pkg.addPart(newSlidePartName, sourcePart.contentType, new Uint8Array(sourcePart.data));
-	const sourceRels = pkg.getRels(sourcePartName);
-	if (sourceRels !== null) pkg.setRels(newSlidePartName, { items: sourceRels.items.map((r) => ({ ...r })) });
+	duplicatePartGraph(pkg, sourcePartName, partName(`/ppt/slides/slide${slideN}.xml`), new Set([
+		REL_TYPES.slideLayout,
+		REL_TYPES.slideMaster,
+		REL_TYPES.notesMaster,
+		REL_TYPES.handoutMaster,
+		REL_TYPES.theme,
+		REL_TYPES.slide,
+		REL_TYPES.image,
+		REL_TYPES.media,
+		REL_TYPES.video,
+		REL_TYPES.audio
+	]));
 	const presRels = pkg.getRels(PRES_PART_NAME) ?? emptyRels();
 	const newRId = nextRelId(presRels.items.map((r) => r.id));
 	presRels.items.push({
@@ -17354,8 +17437,8 @@ const ungroupShapes = (group) => {
 };
 //#endregion
 //#region src/api/index.ts
-const VERSION = "0.16.0";
+const VERSION = "0.16.1";
 //#endregion
 export { slideHasAnimations as $, getTableCellMargins as $a, clearSlideHyperlinks as $i, getShapeText as $n, getSlideLayouts as $o, getShapeRunCount as $r, getCommentAuthor as $s, getShapeStrokeColorResolved as $t, getPresentationTextLength as A, clearSlideTransition as Aa, getShapeImageContrast as Ai, findShapesAtPoint as An, setTableStyleFlags as Ao, setShapeSize as Ar, getSlideLayoutBackgroundImageBytes as As, setShapeTextBodyRotationDeg as At, getSlideText as B, listPackageParts as Ba, isShapeImageGrayscale as Bi, getShapeCenter as Bn, setCoreProperties as Bo, getParagraphAlignment as Br, setSlideBackgroundImage as Bs, getShapeEffectsEffective as Bt, findSlideByTitle as C, getSlidesWithOverlap as Ca, pt as Cc, findSlidesByLayoutName as Ci, getSlideLayout as Cn, setTableCellMargins as Co, setShapeGradientFill as Cr, getSlideBackground as Cs, getShapeTextWrap as Ct, getOutlineText as D, removeSlideNotes as Da, getShapeImageBiLevelThreshold as Di, setSlideLayout as Dn, setTableCellTextFormat as Do, setShapePatternFill as Dr, getSlideColorMapOverride as Ds, setShapeText as Dt, getAllShapes as E, hasSlideNotes as Ea, getPresentationImageCountsBySlide as Ei, replaceTokensInSlide as En, setTableCellTextDirection as Eo, setShapeNoStroke as Er, getSlideBackgroundPatternFill as Es, setShapeParagraphs as Et, getSlideIndex as F, getMediaParts as Fa, getShapeImageLinkUrl as Fi, getMaxShapeIdInPresentation as Fn, getCoreProperties as Fo, setShapeStrokeDash as Fr, getSlideMasterBackgroundGradientFill as Fs, setShapeTextWrap as Ft, isSlideHidden as G, clearTableCellFill as Ga, SLIDE_SIZE_16_10 as Gi, getShapeKind as Gn, findSlideLayoutByPartName as Go, getParagraphIndent as Gr, clearAllSlideComments as Gs, getShapeFill as Gt, getSlideXmlString as H, setMediaPartBytes as Ha, setShapeImageContrast as Hi, getShapeDescription as Hn, touchModified as Ho, getParagraphBulletImageBytes as Hr, setShapeClickAction as Hs, setShapeShadow as Ht, getSlideInfo as I, getOrphanMediaPartNames as Ia, getShapeImageOpacity as Ii, getShapeAdjustValues as In, getExtendedProperties as Io, setShapeStrokeJoin as Ir, getSlideMasterBackgroundImageBytes as Is, clearShapeEffects as It, replaceTextInSlide as J, getTableCell as Ja, getSlideSize as Ji, getShapePlaceholderType as Jn, getSlideLayoutPartName as Jo, getParagraphSpacing as Jr, findCommentsAfter as Js, getShapeFillEffective as Jt, replaceTextInNotes as K, getPresentationTableCountsBySlide as Ka, SLIDE_SIZE_16_9 as Ki, getShapeName as Kn, findSlideLayoutByType as Ko, getParagraphLevel as Kr, clearSlideComments as Ks, getShapeFillColor as Kt, getSlideLayoutCount as L, getPackageSize as La, getShapeImagePartName as Li, getShapeAltTitle as Ln, getPresentationCreated as Lo, getShapeRunFormat as Lr, getSlideMasterBackgroundPatternFill as Ls, findShapesByEffect as Lt, getShapeAt as M, setSlideTransition as Ma, getShapeImageDuotone as Mi, getGroupChildren as Mn, getThumbnail as Mo, setShapeStrokeArrow as Mr, getSlideLayoutBackgroundShapes as Ms, setShapeTextDirection as Mt, getSlideAt as N, _internalPackageOf as Na, getShapeImageFillBytes as Ni, getGroupTransform as Nn, removeThumbnail as No, setShapeStrokeCap as Nr, getSlideLayoutShapes as Ns, setShapeTextFormat as Nt, getPresentationShapeCountsBySlide as O, replaceHyperlink as Oa, getShapeImageBrightness as Oi, translateShapes as On, setTableColumnWidth as Oo, setShapePosition as Or, getSlideLayoutBackground as Os, setShapeTextAnchor as Ot, getSlideCount as P, compactPackage as Pa, getShapeImageFormat as Pi, getMaxShapeId as Pn, setThumbnail as Po, setShapeStrokeCompound as Pr, getSlideMasterBackground as Ps, setShapeTextMargins as Pt, setSlideHidden as Q, getTableCellFill as Qa, clearAllSlideNotes as Qi, getShapeSize as Qn, getSlideLayoutUsageCountsByType as Qo, getShapeRunClickAction as Qr, findSlidesWithCommentsByAuthor as Qs, getShapeStrokeColor as Qt, getSlideOutline as R, getPresentationSummary as Ra, hasShapeImage as Ri, getShapeBounds as Rn, getPresentationModified as Ro, resolveDrawingColor as Rr, getSlideMasterShapes as Rs, getShapeEffect as Rt, findSlideByText as S, getSlidesWithNotes as Sa, mm as Sc, findShapesOutsideCanvas as Si, getShapesBounds as Sn, setTableCellFill as So, setShapeFlip as Sr, clearSlideBackground as Ss, getShapeTextMargins as St, findSlidesByText as T, getVisibleSlides as Ta, findSlidesByLayoutType as Ti, getSlidesWithEmptyPlaceholders as Tn, setTableCellText as To, setShapeNoFill as Tr, getSlideBackgroundImageBytes as Ts, setShapeBullets as Tt, getSlides as U, slidesUsingMediaPart as Ua, setShapeImageCrop as Ui, getShapeFlip as Un, findLayoutsWithPlaceholderType as Uo, getParagraphBulletStyle as Ur, setShapeImage as Us, getShapeGradientFill as Ut, getSlideTextLength as V, readPackagePart as Va, setShapeImageBrightness as Vi, getShapeCustomGeometry as Vn, setExtendedProperties as Vo, getParagraphBullet as Vr, getShapeClickAction as Vs, setShapeGlow as Vt, getSlidesByLayout as W, validatePresentation as Wa, setShapeImageOpacity as Wi, getShapeId as Wn, findSlideLayout as Wo, getParagraphEndFormat as Wr, addSlideComment as Ws, getShapeGradientFillEffective as Wt, replaceTokensInPresentation as X, getTableCellAnchor as Xa, appendSlideNotes as Xi, getShapePreset as Xn, getSlideLayoutType as Xo, getShapeParagraphCount as Xr, findCommentsByAuthor as Xs, getShapeStroke as Xt, replaceTextInSlideNotes as Y, getTableCellAlignment as Ya, setSlideSize as Yi, getShapePosition as Yn, getSlideLayoutPlaceholders as Yo, getShapeHyperlinkTooltip as Yr, findCommentsBefore as Ys, getShapeFillOpacity as Yt, searchSlides as Z, getTableCellBorders as Za, clearAllHyperlinks as Zi, getShapeRotation as Zn, getSlideLayoutUsageCounts as Zo, getShapeParagraphElements as Zr, findCommentsByText as Zs, getShapeStrokeCap as Zt, sortSlides as _, getSlideNotesLength as _a, loadPresentation as _c, findShapesWithAnimation as _i, findSlidePlaceholderByIdx as _n, removeTableColumn as _o, getShapePatternFill as _r, getShapeChartSpec as _s, getShapeTextAutoFit as _t, addContentSlide as a, getAllHyperlinks as aa, getCommentsSortedByDate as ac, setParagraphBullet as ai, findEmptyPlaceholders as an, getTableCells as ao, isShapeHidden as ar, setShapeRunFormat as as, bringShapeForward as at, setSlideSections as b, getSlidesWithHyperlinks as ba, emu as bc, findFlippedShapes as bi, getShapeSlide as bn, setTableCellAnchor as bo, setShapeAdjustValues as br, getEffectiveColorMap as bs, getShapeTextColumns as bt, addSlideAt as c, getAllTables as ca, getPresentationCommenters as cc, setParagraphSpacing as ci, findShapeByText as cn, getTableRowHeights as co, pointInShape as cr, findChartsBySeriesName as cs, copyShape as ct, duplicateSlideAt as d, getHiddenSlides as da, removeSlideComment as dc, getSlideBody as di, findShapesByKind as dn, getTableStyleId as do, setShapeBounds as dr, getPresentationChartCountsBySlide as ds, sendShapeBackward as dt, findSlidesByHyperlink as ea, getCommentAuthors as ec, getShapeRunHyperlink as ei, getShapeStrokeCompound as en, getTableCellParagraphs as eo, getSlideMasterCount as er, getUnusedSlideLayouts as es, addSlideImage as et, importSlide as f, getPresentationHyperlinkCountsBySlide as fa, getPresentationFonts as fc, getSlideTitle as fi, findShapesByName as fn, insertTableColumn as fo, setShapeDescription as fr, getPresentationChartKindCounts as fs, sendShapeToBack as ft, reverseSlides as g, getSlideNotes as ga, createPresentation as gc, clearSlideAnimations as gi, findSlidePlaceholder as gn, mergeTableCells as go, clearShapeStroke as gr, getShapeChartSeriesValues as gs, getShapeTextAnchor as gt, removeSlide as h, getPresentationNotesText as ha, setPresentationTheme as hc, setSlideTitle as hi, findShapesWithHyperlinks as hn, isTableShape as ho, clearShapeFill as hr, getShapeChartSeriesNames as hs, getShapeBodyPrEffective as ht, addBlankSlide as i, getAllComments as ia, getCommentText as ic, setParagraphAlignment as ii, getShapeStrokeWidth as in, getTableCellTextDirection as io, getUnusedSlideMasters as ir, setShapeHyperlink as is, addSlideTextBox as it, getPresentationTextLengthsBySlide as j, getSlideTransition as ja, getShapeImageCrop as ji, findShapesInRect as jn, setTableStyleId as jo, setShapeStroke as jr, getSlideLayoutBackgroundPatternFill as js, setShapeTextColumns as jt, getPresentationText as k, setSlideNotes as ka, getShapeImageBytes as ki, centerShapeOnSlide as kn, setTableRowHeight as ko, setShapeRotation as kr, getSlideLayoutBackgroundGradientFill as ks, setShapeTextAutoFit as kt, addTitleSlide as l, getDistinctHyperlinkUrls as la, getSlideCommentAuthors as lc, setShapeRunHyperlink as li, findShapeInPresentation as ln, getTableSize as lo, renameShape as lr, findChartsWithDataLabels as ls, getShapeZIndex as lt, moveSlide as m, getPresentationNotesLengthsBySlide as ma, setPresentationFonts as mc, setSlidePlaceholders as mi, findShapesByText as mn, isChartShape as mo, shapesOverlap as mr, getShapeChartKind as ms, appendShapeText as mt, groupShapes as n, findSlidesWithChartTrendlines as na, getCommentPosition as nc, getShapeRunText as ni, getShapeStrokeJoin as nn, getTableCellSpan as no, getSlideMasterPartNames as nr, getShapeHyperlink as ns, addSlideShape as nt, addSectionHeaderSlide as o, getAllImages as oa, getPresentationCommentCountsByAuthor as oc, setParagraphLevel as oi, findShapeById as on, getTableColumnWidths as oo, isShapePlaceholder as or, addSlideChart as os, bringShapeToFront as ot, mergePresentations as p, getPresentationNotesLength as pa, getPresentationTheme as pc, setSlideBody as pi, findShapesByPreset as pn, insertTableRow as po, setShapeHidden as pr, getShapeChartCategories as ps, setShapeZIndex as pt, replaceTextInPresentation as q, getSlideTables as qa, SLIDE_SIZE_4_3 as qi, getShapePlaceholderIdx as qn, getSlideLayoutName as qo, getParagraphLineSpacing as qr, findCommentAuthorByName as qs, getShapeFillColorResolved as qt, ungroupShapes as r, getAllCharts as ra, getCommentSlide as rc, isParagraphBulletPicture as ri, getShapeStrokeOpacity as rn, getTableCellText as ro, getSlideMasterUsageCounts as rr, getShapeRunFormatEffective as rs, addSlideTable as rt, addSlide as s, getAllNotes as sa, getPresentationCommentCountsBySlide as sc, setParagraphLineSpacing as si, findShapeByName as sn, getTableDimensions as so, isShapeTextBox as sr, findChartByKind as ss, clearSlideShapes as st, VERSION as t, findSlidesWithChartKind as ta, getCommentDate as tc, getShapeRunHyperlinkTooltip as ti, getShapeStrokeEffective as tn, getTableCellPosition as to, getSlideMasterPartName as tr, getParagraphPropertiesEffective as ts, addSlideLine as tt, duplicateSlide as u, getEmptySlides as ua, getSlideComments as uc, setShapeRunText as ui, findShapesByHyperlink as un, getTableStyleFlags as uo, setShapeAltTitle as ur, findChartsWithTrendlines as us, removeShape as ut, swapSlides as v, getSlidesWithCharts as va, savePresentation as vc, getShapeAnimation as vi, findSlidePlaceholders as vn, removeTableRow as vo, getShapeStrokeArrow as vr, getSlideCharts as vs, getShapeTextAutoFitParams as vt, findSlidesByNotes as w, getSlidesWithTables as wa, findSlidesByLayoutPartName as wi, getSlideShapes as wn, setTableCellParagraphs as wo, setShapeImageFill as wr, getSlideBackgroundGradientFill as ws, setShapeAlignment as wt, findSlideByPartName as x, getSlidesWithImages as xa, inches as xc, findOverlappingShapePairs as xi, getShapeXmlString as xn, setTableCellBorders as xo, setShapeFill as xr, resolveDeckBodyTextColor as xs, getShapeTextDirection as xt, getSlideSections as y, getSlidesWithComments as ya, cm as yc, setShapeAnimation as yi, getShapeIndex as yn, setTableCellAlignment as yo, getShapeStrokeDash as yr, setChartSpec as ys, getShapeTextBodyRotationDeg as yt, getSlidePartName as z, getSlideMediaPartNames as za, hasShapeText as zi, getShapeBoundsResolved as zn, incrementRevision as zo, resolveDrawingColorOpacity as zr, setSlideBackground as zs, getShapeEffects as zt };
 
-//# sourceMappingURL=api-DQEn2Bo4.js.map
+//# sourceMappingURL=api-Dt6q_IAv.js.map