@office-kit/pptx-dev 0.2.1 → 0.2.3

package/README.md

@@ -16,7 +16,7 @@ npm install
 npm run dev
 ```
 
-Open the local URL printed by the server. Save `deck.tsx` to rebuild. The viewer
+Open the local URL printed by the server. Save a slide file, `theme.ts` or `deck.tsx` to rebuild. The viewer
 has a vertical thumbnail strip and a large slide canvas. Click a thumbnail or use
 arrow keys, Page Up/Down, Home/End to navigate. Fit/zoom and Present (Escape to
 exit) are viewing controls; the canvas has no editing, dragging or resize handles.
@@ -45,6 +45,27 @@ presentation** task, then use **Simple Browser: Show** with the printed URL and
 move it to a side editor group. No custom editor extension is needed for this
 workflow. Preview-to-source selection is not implemented.
 
+## Edit only what changed
+
+New projects separate slide order, content and shared styling:
+
+```text
+deck.tsx          # Slide imports and order
+slides/cover.tsx  # One slide per descriptively named file
+theme.ts          # Shared design values
+```
+
+For example, a headline revision changes only the text in the corresponding
+slide file. A deck-wide palette change belongs in `theme.ts`; a one-slide color
+exception belongs in that slide's props. Imported files are watched, so keep the
+preview running while editing. Existing single-file decks remain supported and
+do not need migration for a small revision.
+
+Use focused code patches for revisions. Review affected slides while iterating;
+check types, export and review the whole deck before delivery. The build still
+evaluates the whole presentation; file splitting reduces authoring scope, not
+the amount of PPTX evaluation.
+
 ## Commands
 
 - `office-pptx init <new-directory>` creates a TSX project without overwriting an existing directory.

package/dist/cli.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { a as createDeckBuilder, i as initProject, n as exportDeck, r as inspectTemplate } from "./src-U5ZNAbtV.mjs";
+import { a as createDeckBuilder, i as initProject, n as exportDeck, r as inspectTemplate } from "./src-31HzWTvZ.mjs";
 import { dirname, resolve, sep } from "node:path";
 import { watch } from "node:fs";
 import { createServer } from "node:http";

package/dist/index.d.mts

@@ -16,25 +16,8 @@ declare function initProject(directory: string): Promise<string>;
 //#region src/inspect.d.ts
 /** Source references usable directly in Slide, Fill and Remove props. */
 declare function inspectTemplate(file: string): Promise<{
-  slides: {
-    index: number;
-    part: string;
-    title: string | null;
-    shapes: {
-      id: number;
-      name: string;
-      kind: "shape" | "picture" | "group" | "graphicFrame" | "connector";
-      placeholder: {
-        type: string | null;
-        idx: number | null;
-      };
-    }[];
-  }[];
-  layouts: {
-    part: string;
-    name: string;
-    type: string | null;
-  }[];
+  slides: any;
+  layouts: any;
 }>;
 //#endregion
 //#region src/index.d.ts

package/dist/index.mjs

@@ -1,2 +1,2 @@
-import { i as initProject, n as exportDeck, r as inspectTemplate, t as buildDeck } from "./src-U5ZNAbtV.mjs";
+import { i as initProject, n as exportDeck, r as inspectTemplate, t as buildDeck } from "./src-31HzWTvZ.mjs";
 export { buildDeck, exportDeck, initProject, inspectTemplate };

package/dist/{src-U5ZNAbtV.mjs → src-31HzWTvZ.mjs}

@@ -71,25 +71,43 @@ function createDeckBuilder(entry, keepWarm = true) {
 }
 //#endregion
 //#region src/init.ts
-const starter = `import { Presentation, Slide, Text, Shape } from '@office-kit/pptx-dsl';
+const starter = `import { Presentation } from '@office-kit/pptx-dsl';
+import { Cover } from './slides/cover.tsx';
 
 export default (
   <Presentation>
-    <Slide background="#15171C">
-      <Shape preset="rect" x={0.9} y={2.55} width={0.14} height={1.75} fill="#E5481F" stroke={false} />
-      <Text x={1.25} y={2.4} width={10} height={1.1} size={48} bold color="#FFFFFF">
+    <Cover />
+  </Presentation>
+);
+`;
+const theme = `export const theme = {
+  background: '#15171C',
+  accent: '#E5481F',
+  text: '#FFFFFF',
+  muted: '#B4B9C4',
+} as const;
+`;
+const cover = `import { Slide, Text, Shape } from '@office-kit/pptx-dsl';
+import { theme } from '../theme.ts';
+
+export function Cover() {
+  return (
+    <Slide background={theme.background}>
+      <Shape preset="rect" x={0.9} y={2.55} width={0.14} height={1.75} fill={theme.accent} stroke={false} />
+      <Text x={1.25} y={2.4} width={10} height={1.1} size={48} bold color={theme.text}>
         Your next presentation
       </Text>
-      <Text x={1.25} y={3.55} width={10} height={0.6} size={22} color="#B4B9C4">
+      <Text x={1.25} y={3.55} width={10} height={0.6} size={22} color={theme.muted}>
         Edit this TSX and save to update the preview.
       </Text>
     </Slide>
-  </Presentation>
-);
+  );
+}
 `;
 const guide = `# Writing this presentation
 
-Edit deck.tsx and local TypeScript components. The JSX runtime is
+Use deck.tsx for slide order, slides/*.tsx for individual slides, and theme.ts
+for shared design values. The JSX runtime is
 @office-kit/pptx-dsl, with no React or Vue dependency.
 
 - Run npm run dev, then open its local URL to preview. Saving source files
@@ -97,8 +115,16 @@ Edit deck.tsx and local TypeScript components. The JSX runtime is
 - The preview is view-only: use the vertical thumbnails to select slides, zoom
   to inspect details, and Present to view full-screen (Escape exits). Make all
   content and layout changes in TSX; there are no canvas editing controls.
-- Run npm run check for TypeScript diagnostics; run npm run build to export
-  deck.pptx. Inspect every slide in the preview after changes.
+- For a local revision, locate the slide through deck.tsx or a text search and
+  read only the relevant source and dependencies. Patch the requested text, data
+  or props; do not regenerate the deck or reformat unrelated code. Keep descriptive
+  filenames stable when reordering slides. Preserve existing project structures.
+- Change shared theme values/components only for changes intended for all their
+  consumers; use a local prop override for a one-slide exception.
+- Keep the preview running during revisions and inspect affected slides after
+  saving. Review all affected consumers for shared changes. Do not run a separate
+  export for every intermediate edit. Before delivery, run npm run check and
+  npm run build to export deck.pptx, then review the whole deck.
 - Coordinates and dimensions are inches; font sizes and stroke widths are points.
   The default 16:9 canvas is 13.333 × 7.5 inches.
 - Use native Text, Shape, Image, Table and Chart elements. Use JS functions,
@@ -171,6 +197,8 @@ async function initProject(directory) {
 			exclude: ["node_modules"]
 		}, null, 2) + "\n",
 		"deck.tsx": starter,
+		"theme.ts": theme,
+		"slides/cover.tsx": cover,
 		"CLAUDE.md": guide,
 		".gitignore": "node_modules/\ndeck.pptx\n",
 		".vscode/tasks.json": JSON.stringify({
@@ -209,7 +237,7 @@ async function initProject(directory) {
 			]
 		}, null, 2) + "\n"
 	};
-	await mkdir(join(root, ".vscode"));
+	await Promise.all([".vscode", "slides"].map((directory) => mkdir(join(root, directory))));
 	await Promise.all(Object.entries(files).map(([name, content]) => writeFile(join(root, name), content, { flag: "wx" })));
 	return root;
 }
@@ -259,4 +287,4 @@ async function exportDeck(entry, output) {
 //#endregion
 export { createDeckBuilder as a, initProject as i, exportDeck as n, inspectTemplate as r, buildDeck as t };
 
-//# sourceMappingURL=src-U5ZNAbtV.mjs.map
+//# sourceMappingURL=src-31HzWTvZ.mjs.map

package/dist/src-31HzWTvZ.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"src-31HzWTvZ.mjs","names":[],"sources":["../src/build-runner.ts","../src/init.ts","../src/inspect.ts","../src/index.ts"],"sourcesContent":["import { Worker } from 'node:worker_threads';\nimport { resolve, join } from 'node:path';\nimport { mkdtempSync } from 'node:fs';\nimport { rm } from 'node:fs/promises';\nimport { tmpdir } from 'node:os';\nimport type { BuildResult } from './build.ts';\n\nconst BUILD_TIMEOUT_MS = 60_000;\n\nfunction prepareWorker(entry: string) {\n  const directory = mkdtempSync(join(tmpdir(), 'office-pptx-'));\n  const worker = new Worker(new URL('./worker.mjs', import.meta.url), {\n    workerData: { entry: resolve(entry), directory },\n    execArgv: ['--enable-source-maps'],\n  });\n  const result = new Promise<BuildResult>((resolveBuild, reject) => {\n    worker.once('message', resolveBuild);\n    worker.once('error', reject);\n    worker.once('exit', (code) =>\n      reject(new Error(`Build worker exited without a result (code ${code}).`)),\n    );\n  });\n  // Startup may fail before the next edit asks to use this worker.\n  void result.catch(() => {});\n  return { worker, result, directory };\n}\n\n/** Internal watch session. Preload libraries, but never reuse a user module cache. */\nexport function createDeckBuilder(entry: string, keepWarm = true) {\n  let prepared: ReturnType<typeof prepareWorker> | undefined = prepareWorker(entry);\n  let closed = false;\n  let active = false;\n  return {\n    async build(): Promise<BuildResult> {\n      if (closed || active) throw new Error('Deck builder is closed or already building.');\n      active = true;\n      const current = prepared ?? prepareWorker(entry);\n      prepared = current;\n      let timer: ReturnType<typeof setTimeout> | undefined;\n      try {\n        current.worker.postMessage('build');\n        return await Promise.race([\n          current.result,\n          new Promise<never>((_, reject) => {\n            timer = setTimeout(\n              () =>\n                reject(\n                  new Error(\n                    'Build exceeded 60 seconds. Check the deck for loops or unresolved promises.',\n                  ),\n                ),\n              BUILD_TIMEOUT_MS,\n            );\n          }),\n        ]);\n      } finally {\n        clearTimeout(timer);\n        await current.worker.terminate();\n        await rm(current.directory, { recursive: true, force: true });\n        active = false;\n        prepared = !closed && keepWarm ? prepareWorker(entry) : undefined;\n      }\n    },\n    async cancel() {\n      if (active) await prepared?.worker.terminate();\n    },\n    async close() {\n      closed = true;\n      const current = prepared;\n      await current?.worker.terminate();\n      if (current) await rm(current.directory, { recursive: true, force: true });\n    },\n  };\n}\n","import { mkdir, readFile, writeFile } from 'node:fs/promises';\nimport { join, resolve } from 'node:path';\n\nconst starter = `import { Presentation } from '@office-kit/pptx-dsl';\nimport { Cover } from './slides/cover.tsx';\n\nexport default (\n  <Presentation>\n    <Cover />\n  </Presentation>\n);\n`;\n\nconst theme = `export const theme = {\n  background: '#15171C',\n  accent: '#E5481F',\n  text: '#FFFFFF',\n  muted: '#B4B9C4',\n} as const;\n`;\n\nconst cover = `import { Slide, Text, Shape } from '@office-kit/pptx-dsl';\nimport { theme } from '../theme.ts';\n\nexport function Cover() {\n  return (\n    <Slide background={theme.background}>\n      <Shape preset=\"rect\" x={0.9} y={2.55} width={0.14} height={1.75} fill={theme.accent} stroke={false} />\n      <Text x={1.25} y={2.4} width={10} height={1.1} size={48} bold color={theme.text}>\n        Your next presentation\n      </Text>\n      <Text x={1.25} y={3.55} width={10} height={0.6} size={22} color={theme.muted}>\n        Edit this TSX and save to update the preview.\n      </Text>\n    </Slide>\n  );\n}\n`;\n\nconst guide = `# Writing this presentation\n\nUse deck.tsx for slide order, slides/*.tsx for individual slides, and theme.ts\nfor shared design values. The JSX runtime is\n@office-kit/pptx-dsl, with no React or Vue dependency.\n\n- Run npm run dev, then open its local URL to preview. Saving source files\n  updates the preview. A failed build retains the last successful output.\n- The preview is view-only: use the vertical thumbnails to select slides, zoom\n  to inspect details, and Present to view full-screen (Escape exits). Make all\n  content and layout changes in TSX; there are no canvas editing controls.\n- For a local revision, locate the slide through deck.tsx or a text search and\n  read only the relevant source and dependencies. Patch the requested text, data\n  or props; do not regenerate the deck or reformat unrelated code. Keep descriptive\n  filenames stable when reordering slides. Preserve existing project structures.\n- Change shared theme values/components only for changes intended for all their\n  consumers; use a local prop override for a one-slide exception.\n- Keep the preview running during revisions and inspect affected slides after\n  saving. Review all affected consumers for shared changes. Do not run a separate\n  export for every intermediate edit. Before delivery, run npm run check and\n  npm run build to export deck.pptx, then review the whole deck.\n- Coordinates and dimensions are inches; font sizes and stroke widths are points.\n  The default 16:9 canvas is 13.333 × 7.5 inches.\n- Use native Text, Shape, Image, Table and Chart elements. Use JS functions,\n  arrays and map to compose elements; do not import React.\n- Chart takes the core ChartSpec in its spec prop. Text accepts rich ParagraphSpec\n  arrays through paragraphs. Raw is an escape hatch for public core APIs.\n- For templates: readFile(new URL('./template.pptx', import.meta.url)), then use\n  Presentation source={bytes} mode=\"edit\" and Slide target={{index: 0}}.\n  Fill target={{name: 'Title 1'}} changes an existing shape. Indices are zero-based.\n  Use office-pptx inspect template.pptx to discover names, layouts and placeholders.\n- Use mode=\"compose\" and Slide from={{index: 0}} to build a new sequence from a\n  source deck. This intentionally removes the original slide sequence.\n- Keep assets inside this project so the dev server sees changes. Use source-relative\n  new URL('./image.png', import.meta.url) when loading local assets.\n- Preserve existing slides and formatting unless the request calls for changes.\n  Never rasterize a chart/table as a shortcut. Raw-only features are not DSL coverage.\n- Preview is a rendering aid, not a guarantee of identical PowerPoint rendering.\n  Check the exported file in the target application for final delivery.\n\nVSCode uses tsconfig.json for completion and diagnostics. Start the\n\"Preview presentation\" task, then run \"Simple Browser: Show\" with the printed URL\nand move that editor to a side group. Type errors appear in the Problems panel.\n`;\n\n/** Creates a new directory; existing projects are never overwritten. */\nexport async function initProject(directory: string): Promise<string> {\n  const root = resolve(directory);\n  const packageLocations = [\n    import.meta.resolve('@office-kit/pptx/package.json'),\n    import.meta.resolve('@office-kit/pptx-dsl/package.json'),\n    new URL('../package.json', import.meta.url),\n  ];\n  const versions = await Promise.all(\n    packageLocations.map(async (location) => {\n      const manifest: { version: string } = JSON.parse(await readFile(new URL(location), 'utf8'));\n      return `^${manifest.version}`;\n    }),\n  );\n  await mkdir(root);\n  const files: Record<string, string> = {\n    'package.json':\n      JSON.stringify(\n        {\n          name: 'my-presentation',\n          private: true,\n          type: 'module',\n          scripts: {\n            dev: 'office-pptx dev deck.tsx',\n            build: 'office-pptx build deck.tsx --out deck.pptx',\n            check: 'tsc --noEmit',\n          },\n          dependencies: { '@office-kit/pptx': versions[0]!, '@office-kit/pptx-dsl': versions[1]! },\n          devDependencies: {\n            '@office-kit/pptx-dev': versions[2]!,\n            '@types/node': '^24.13.2',\n            typescript: '^6.0.3',\n          },\n        },\n        null,\n        2,\n      ) + '\\n',\n    'tsconfig.json':\n      JSON.stringify(\n        {\n          compilerOptions: {\n            target: 'ES2022',\n            module: 'ESNext',\n            moduleResolution: 'Bundler',\n            jsx: 'react-jsx',\n            jsxImportSource: '@office-kit/pptx-dsl',\n            strict: true,\n            exactOptionalPropertyTypes: true,\n            noEmit: true,\n            allowImportingTsExtensions: true,\n            types: ['node'],\n          },\n          include: ['**/*.ts', '**/*.tsx'],\n          exclude: ['node_modules'],\n        },\n        null,\n        2,\n      ) + '\\n',\n    'deck.tsx': starter,\n    'theme.ts': theme,\n    'slides/cover.tsx': cover,\n    'CLAUDE.md': guide,\n    '.gitignore': 'node_modules/\\ndeck.pptx\\n',\n    '.vscode/tasks.json':\n      JSON.stringify(\n        {\n          version: '2.0.0',\n          tasks: [\n            {\n              label: 'Preview presentation',\n              type: 'shell',\n              command: 'npm run dev',\n              isBackground: true,\n              problemMatcher: {\n                pattern: { regexp: '^NEVER_MATCH$', file: 1, message: 2 },\n                background: {\n                  activeOnStart: true,\n                  beginsPattern: '^.*office-pptx dev',\n                  endsPattern: '^Preview: ',\n                },\n              },\n            },\n            {\n              label: 'Check presentation',\n              type: 'shell',\n              command: 'npm run check',\n              problemMatcher: '$tsc',\n            },\n            {\n              label: 'Export presentation',\n              type: 'shell',\n              command: 'npm run build',\n              problemMatcher: [],\n            },\n          ],\n        },\n        null,\n        2,\n      ) + '\\n',\n  };\n  await Promise.all(['.vscode', 'slides'].map((directory) => mkdir(join(root, directory))));\n  await Promise.all(\n    Object.entries(files).map(([name, content]) =>\n      writeFile(join(root, name), content, { flag: 'wx' }),\n    ),\n  );\n  return root;\n}\n","import { readFile } from 'node:fs/promises';\nimport {\n  loadPresentation,\n  getSlides,\n  getSlidePartName,\n  getSlideTitle,\n  getSlideShapes,\n  getShapeName,\n  getShapeId,\n  getShapeKind,\n  getShapePlaceholderType,\n  getShapePlaceholderIdx,\n  getSlideLayouts,\n  getSlideLayoutName,\n  getSlideLayoutPartName,\n  getSlideLayoutType,\n} from '@office-kit/pptx';\n\n/** Source references usable directly in Slide, Fill and Remove props. */\nexport async function inspectTemplate(file: string) {\n  const presentation = await loadPresentation(await readFile(file));\n  return {\n    slides: getSlides(presentation).map((slide, index) => ({\n      index,\n      part: getSlidePartName(slide),\n      title: getSlideTitle(slide),\n      shapes: getSlideShapes(slide).map((shape) => ({\n        id: getShapeId(shape),\n        name: getShapeName(shape),\n        kind: getShapeKind(shape),\n        placeholder: { type: getShapePlaceholderType(shape), idx: getShapePlaceholderIdx(shape) },\n      })),\n    })),\n    layouts: getSlideLayouts(presentation).map((layout) => ({\n      part: getSlideLayoutPartName(layout),\n      name: getSlideLayoutName(layout),\n      type: getSlideLayoutType(layout),\n    })),\n  };\n}\n","import { writeFile } from 'node:fs/promises';\nimport { createDeckBuilder } from './build-runner.ts';\nimport type { BuildResult } from './build.ts';\nexport type { BuildResult } from './build.ts';\nexport { initProject } from './init.ts';\nexport { inspectTemplate } from './inspect.ts';\n\n/** Each evaluation gets a fresh module cache and releases it when finished. */\nexport async function buildDeck(entry: string): Promise<BuildResult> {\n  const builder = createDeckBuilder(entry, false);\n  try {\n    return await builder.build();\n  } finally {\n    await builder.close();\n  }\n}\nexport async function exportDeck(entry: string, output: string): Promise<BuildResult> {\n  const result = await buildDeck(entry);\n  await writeFile(output, result.bytes);\n  return result;\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@office-kit/pptx-dev",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "Build and preview PowerPoint TSX presentations locally",
   "license": "MIT",
   "repository": {
@@ -28,8 +28,8 @@
   },
   "dependencies": {
     "esbuild": "^0.28.1",
-    "@office-kit/pptx": "^0.17.0",
-    "@office-kit/pptx-dsl": "^0.3.0",
+    "@office-kit/pptx": "^0.18.0",
+    "@office-kit/pptx-dsl": "^0.5.0",
     "@office-kit/pptx-preview": "^0.9.6"
   },
   "devDependencies": {

package/dist/src-U5ZNAbtV.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"src-U5ZNAbtV.mjs","names":[],"sources":["../src/build-runner.ts","../src/init.ts","../src/inspect.ts","../src/index.ts"],"sourcesContent":["import { Worker } from 'node:worker_threads';\nimport { resolve, join } from 'node:path';\nimport { mkdtempSync } from 'node:fs';\nimport { rm } from 'node:fs/promises';\nimport { tmpdir } from 'node:os';\nimport type { BuildResult } from './build.ts';\n\nconst BUILD_TIMEOUT_MS = 60_000;\n\nfunction prepareWorker(entry: string) {\n  const directory = mkdtempSync(join(tmpdir(), 'office-pptx-'));\n  const worker = new Worker(new URL('./worker.mjs', import.meta.url), {\n    workerData: { entry: resolve(entry), directory },\n    execArgv: ['--enable-source-maps'],\n  });\n  const result = new Promise<BuildResult>((resolveBuild, reject) => {\n    worker.once('message', resolveBuild);\n    worker.once('error', reject);\n    worker.once('exit', (code) =>\n      reject(new Error(`Build worker exited without a result (code ${code}).`)),\n    );\n  });\n  // Startup may fail before the next edit asks to use this worker.\n  void result.catch(() => {});\n  return { worker, result, directory };\n}\n\n/** Internal watch session. Preload libraries, but never reuse a user module cache. */\nexport function createDeckBuilder(entry: string, keepWarm = true) {\n  let prepared: ReturnType<typeof prepareWorker> | undefined = prepareWorker(entry);\n  let closed = false;\n  let active = false;\n  return {\n    async build(): Promise<BuildResult> {\n      if (closed || active) throw new Error('Deck builder is closed or already building.');\n      active = true;\n      const current = prepared ?? prepareWorker(entry);\n      prepared = current;\n      let timer: ReturnType<typeof setTimeout> | undefined;\n      try {\n        current.worker.postMessage('build');\n        return await Promise.race([\n          current.result,\n          new Promise<never>((_, reject) => {\n            timer = setTimeout(\n              () =>\n                reject(\n                  new Error(\n                    'Build exceeded 60 seconds. Check the deck for loops or unresolved promises.',\n                  ),\n                ),\n              BUILD_TIMEOUT_MS,\n            );\n          }),\n        ]);\n      } finally {\n        clearTimeout(timer);\n        await current.worker.terminate();\n        await rm(current.directory, { recursive: true, force: true });\n        active = false;\n        prepared = !closed && keepWarm ? prepareWorker(entry) : undefined;\n      }\n    },\n    async cancel() {\n      if (active) await prepared?.worker.terminate();\n    },\n    async close() {\n      closed = true;\n      const current = prepared;\n      await current?.worker.terminate();\n      if (current) await rm(current.directory, { recursive: true, force: true });\n    },\n  };\n}\n","import { mkdir, readFile, writeFile } from 'node:fs/promises';\nimport { join, resolve } from 'node:path';\n\nconst starter = `import { Presentation, Slide, Text, Shape } from '@office-kit/pptx-dsl';\n\nexport default (\n  <Presentation>\n    <Slide background=\"#15171C\">\n      <Shape preset=\"rect\" x={0.9} y={2.55} width={0.14} height={1.75} fill=\"#E5481F\" stroke={false} />\n      <Text x={1.25} y={2.4} width={10} height={1.1} size={48} bold color=\"#FFFFFF\">\n        Your next presentation\n      </Text>\n      <Text x={1.25} y={3.55} width={10} height={0.6} size={22} color=\"#B4B9C4\">\n        Edit this TSX and save to update the preview.\n      </Text>\n    </Slide>\n  </Presentation>\n);\n`;\n\nconst guide = `# Writing this presentation\n\nEdit deck.tsx and local TypeScript components. The JSX runtime is\n@office-kit/pptx-dsl, with no React or Vue dependency.\n\n- Run npm run dev, then open its local URL to preview. Saving source files\n  updates the preview. A failed build retains the last successful output.\n- The preview is view-only: use the vertical thumbnails to select slides, zoom\n  to inspect details, and Present to view full-screen (Escape exits). Make all\n  content and layout changes in TSX; there are no canvas editing controls.\n- Run npm run check for TypeScript diagnostics; run npm run build to export\n  deck.pptx. Inspect every slide in the preview after changes.\n- Coordinates and dimensions are inches; font sizes and stroke widths are points.\n  The default 16:9 canvas is 13.333 × 7.5 inches.\n- Use native Text, Shape, Image, Table and Chart elements. Use JS functions,\n  arrays and map to compose elements; do not import React.\n- Chart takes the core ChartSpec in its spec prop. Text accepts rich ParagraphSpec\n  arrays through paragraphs. Raw is an escape hatch for public core APIs.\n- For templates: readFile(new URL('./template.pptx', import.meta.url)), then use\n  Presentation source={bytes} mode=\"edit\" and Slide target={{index: 0}}.\n  Fill target={{name: 'Title 1'}} changes an existing shape. Indices are zero-based.\n  Use office-pptx inspect template.pptx to discover names, layouts and placeholders.\n- Use mode=\"compose\" and Slide from={{index: 0}} to build a new sequence from a\n  source deck. This intentionally removes the original slide sequence.\n- Keep assets inside this project so the dev server sees changes. Use source-relative\n  new URL('./image.png', import.meta.url) when loading local assets.\n- Preserve existing slides and formatting unless the request calls for changes.\n  Never rasterize a chart/table as a shortcut. Raw-only features are not DSL coverage.\n- Preview is a rendering aid, not a guarantee of identical PowerPoint rendering.\n  Check the exported file in the target application for final delivery.\n\nVSCode uses tsconfig.json for completion and diagnostics. Start the\n\"Preview presentation\" task, then run \"Simple Browser: Show\" with the printed URL\nand move that editor to a side group. Type errors appear in the Problems panel.\n`;\n\n/** Creates a new directory; existing projects are never overwritten. */\nexport async function initProject(directory: string): Promise<string> {\n  const root = resolve(directory);\n  const packageLocations = [\n    import.meta.resolve('@office-kit/pptx/package.json'),\n    import.meta.resolve('@office-kit/pptx-dsl/package.json'),\n    new URL('../package.json', import.meta.url),\n  ];\n  const versions = await Promise.all(\n    packageLocations.map(async (location) => {\n      const manifest: { version: string } = JSON.parse(await readFile(new URL(location), 'utf8'));\n      return `^${manifest.version}`;\n    }),\n  );\n  await mkdir(root);\n  const files: Record<string, string> = {\n    'package.json':\n      JSON.stringify(\n        {\n          name: 'my-presentation',\n          private: true,\n          type: 'module',\n          scripts: {\n            dev: 'office-pptx dev deck.tsx',\n            build: 'office-pptx build deck.tsx --out deck.pptx',\n            check: 'tsc --noEmit',\n          },\n          dependencies: { '@office-kit/pptx': versions[0]!, '@office-kit/pptx-dsl': versions[1]! },\n          devDependencies: {\n            '@office-kit/pptx-dev': versions[2]!,\n            '@types/node': '^24.13.2',\n            typescript: '^6.0.3',\n          },\n        },\n        null,\n        2,\n      ) + '\\n',\n    'tsconfig.json':\n      JSON.stringify(\n        {\n          compilerOptions: {\n            target: 'ES2022',\n            module: 'ESNext',\n            moduleResolution: 'Bundler',\n            jsx: 'react-jsx',\n            jsxImportSource: '@office-kit/pptx-dsl',\n            strict: true,\n            exactOptionalPropertyTypes: true,\n            noEmit: true,\n            allowImportingTsExtensions: true,\n            types: ['node'],\n          },\n          include: ['**/*.ts', '**/*.tsx'],\n          exclude: ['node_modules'],\n        },\n        null,\n        2,\n      ) + '\\n',\n    'deck.tsx': starter,\n    'CLAUDE.md': guide,\n    '.gitignore': 'node_modules/\\ndeck.pptx\\n',\n    '.vscode/tasks.json':\n      JSON.stringify(\n        {\n          version: '2.0.0',\n          tasks: [\n            {\n              label: 'Preview presentation',\n              type: 'shell',\n              command: 'npm run dev',\n              isBackground: true,\n              problemMatcher: {\n                pattern: { regexp: '^NEVER_MATCH$', file: 1, message: 2 },\n                background: {\n                  activeOnStart: true,\n                  beginsPattern: '^.*office-pptx dev',\n                  endsPattern: '^Preview: ',\n                },\n              },\n            },\n            {\n              label: 'Check presentation',\n              type: 'shell',\n              command: 'npm run check',\n              problemMatcher: '$tsc',\n            },\n            {\n              label: 'Export presentation',\n              type: 'shell',\n              command: 'npm run build',\n              problemMatcher: [],\n            },\n          ],\n        },\n        null,\n        2,\n      ) + '\\n',\n  };\n  await mkdir(join(root, '.vscode'));\n  await Promise.all(\n    Object.entries(files).map(([name, content]) =>\n      writeFile(join(root, name), content, { flag: 'wx' }),\n    ),\n  );\n  return root;\n}\n","import { readFile } from 'node:fs/promises';\nimport {\n  loadPresentation,\n  getSlides,\n  getSlidePartName,\n  getSlideTitle,\n  getSlideShapes,\n  getShapeName,\n  getShapeId,\n  getShapeKind,\n  getShapePlaceholderType,\n  getShapePlaceholderIdx,\n  getSlideLayouts,\n  getSlideLayoutName,\n  getSlideLayoutPartName,\n  getSlideLayoutType,\n} from '@office-kit/pptx';\n\n/** Source references usable directly in Slide, Fill and Remove props. */\nexport async function inspectTemplate(file: string) {\n  const presentation = await loadPresentation(await readFile(file));\n  return {\n    slides: getSlides(presentation).map((slide, index) => ({\n      index,\n      part: getSlidePartName(slide),\n      title: getSlideTitle(slide),\n      shapes: getSlideShapes(slide).map((shape) => ({\n        id: getShapeId(shape),\n        name: getShapeName(shape),\n        kind: getShapeKind(shape),\n        placeholder: { type: getShapePlaceholderType(shape), idx: getShapePlaceholderIdx(shape) },\n      })),\n    })),\n    layouts: getSlideLayouts(presentation).map((layout) => ({\n      part: getSlideLayoutPartName(layout),\n      name: getSlideLayoutName(layout),\n      type: getSlideLayoutType(layout),\n    })),\n  };\n}\n","import { writeFile } from 'node:fs/promises';\nimport { createDeckBuilder } from './build-runner.ts';\nimport type { BuildResult } from './build.ts';\nexport type { BuildResult } from './build.ts';\nexport { initProject } from './init.ts';\nexport { inspectTemplate } from './inspect.ts';\n\n/** Each evaluation gets a fresh module cache and releases it when finished. */\nexport async function buildDeck(entry: string): Promise<BuildResult> {\n  const builder = createDeckBuilder(entry, false);\n  try {\n    return await builder.build();\n  } finally {\n    await builder.close();\n  }\n}\nexport async function exportDeck(entry: string, output: string): Promise<BuildResult> {\n  const result = await buildDeck(entry);\n  await writeFile(output, result.bytes);\n  return result;\n}\n"],"mappings":"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"}