plcode-darwin-x64 2.1.0

package/.plcode/skill/experimental/document-pptx/pptxgenjs.md

@@ -0,0 +1,511 @@
+# PptxGenJS Tutorial
+
+## Setup & Basic Structure
+
+```javascript
+const pptxgen = require("pptxgenjs")
+
+let pres = new pptxgen()
+pres.layout = "LAYOUT_16x9" // or 'LAYOUT_16x10', 'LAYOUT_4x3', 'LAYOUT_WIDE'
+pres.author = "Your Name"
+pres.title = "Presentation Title"
+
+let slide = pres.addSlide()
+slide.addText("Hello World!", { x: 0.5, y: 0.5, fontSize: 36, color: "363636" })
+
+pres.writeFile({ fileName: "Presentation.pptx" })
+```
+
+## Layout Dimensions
+
+Slide dimensions (coordinates in inches):
+
+- `LAYOUT_16x9`: 10" × 5.625" (default)
+- `LAYOUT_16x10`: 10" × 6.25"
+- `LAYOUT_4x3`: 10" × 7.5"
+- `LAYOUT_WIDE`: 13.3" × 7.5"
+
+---
+
+## Text & Formatting
+
+```javascript
+// Basic text
+slide.addText("Simple Text", {
+  x: 1,
+  y: 1,
+  w: 8,
+  h: 2,
+  fontSize: 24,
+  fontFace: "Arial",
+  color: "363636",
+  bold: true,
+  align: "center",
+  valign: "middle",
+})
+
+// Character spacing (use charSpacing, not letterSpacing which is silently ignored)
+slide.addText("SPACED TEXT", { x: 1, y: 1, w: 8, h: 1, charSpacing: 6 })
+
+// Rich text arrays
+slide.addText(
+  [
+    { text: "Bold ", options: { bold: true } },
+    { text: "Italic ", options: { italic: true } },
+  ],
+  { x: 1, y: 3, w: 8, h: 1 },
+)
+
+// Multi-line text (requires breakLine: true)
+slide.addText(
+  [
+    { text: "Line 1", options: { breakLine: true } },
+    { text: "Line 2", options: { breakLine: true } },
+    { text: "Line 3" }, // Last item doesn't need breakLine
+  ],
+  { x: 0.5, y: 0.5, w: 8, h: 2 },
+)
+
+// Text box margin (internal padding)
+slide.addText("Title", {
+  x: 0.5,
+  y: 0.3,
+  w: 9,
+  h: 0.6,
+  margin: 0, // Use 0 when aligning text with other elements like shapes or icons
+})
+```
+
+**Tip:** Text boxes have internal margin by default. Set `margin: 0` when you need text to align precisely with shapes, lines, or icons at the same x-position.
+
+---
+
+## Lists & Bullets
+
+```javascript
+// ✅ CORRECT: Multiple bullets
+slide.addText([
+  { text: "First item", options: { bullet: true, breakLine: true } },
+  { text: "Second item", options: { bullet: true, breakLine: true } },
+  { text: "Third item", options: { bullet: true } }
+], { x: 0.5, y: 0.5, w: 8, h: 3 });
+
+// ❌ WRONG: Never use unicode bullets
+slide.addText("• First item", { ... });  // Creates double bullets
+
+// Sub-items and numbered lists
+{ text: "Sub-item", options: { bullet: true, indentLevel: 1 } }
+{ text: "First", options: { bullet: { type: "number" }, breakLine: true } }
+```
+
+---
+
+## Shapes
+
+```javascript
+slide.addShape(pres.shapes.RECTANGLE, {
+  x: 0.5,
+  y: 0.8,
+  w: 1.5,
+  h: 3.0,
+  fill: { color: "FF0000" },
+  line: { color: "000000", width: 2 },
+})
+
+slide.addShape(pres.shapes.OVAL, { x: 4, y: 1, w: 2, h: 2, fill: { color: "0000FF" } })
+
+slide.addShape(pres.shapes.LINE, {
+  x: 1,
+  y: 3,
+  w: 5,
+  h: 0,
+  line: { color: "FF0000", width: 3, dashType: "dash" },
+})
+
+// With transparency
+slide.addShape(pres.shapes.RECTANGLE, {
+  x: 1,
+  y: 1,
+  w: 3,
+  h: 2,
+  fill: { color: "0088CC", transparency: 50 },
+})
+
+// Rounded rectangle (rectRadius only works with ROUNDED_RECTANGLE, not RECTANGLE)
+// ⚠️ Don't pair with rectangular accent overlays — they won't cover rounded corners. Use RECTANGLE instead.
+slide.addShape(pres.shapes.ROUNDED_RECTANGLE, {
+  x: 1,
+  y: 1,
+  w: 3,
+  h: 2,
+  fill: { color: "FFFFFF" },
+  rectRadius: 0.1,
+})
+
+// With shadow
+slide.addShape(pres.shapes.RECTANGLE, {
+  x: 1,
+  y: 1,
+  w: 3,
+  h: 2,
+  fill: { color: "FFFFFF" },
+  shadow: { type: "outer", color: "000000", blur: 6, offset: 2, angle: 135, opacity: 0.15 },
+})
+```
+
+Shadow options:
+
+| Property  | Type   | Range                        | Notes                                                         |
+| --------- | ------ | ---------------------------- | ------------------------------------------------------------- |
+| `type`    | string | `"outer"`, `"inner"`         |                                                               |
+| `color`   | string | 6-char hex (e.g. `"000000"`) | No `#` prefix, no 8-char hex — see Common Pitfalls            |
+| `blur`    | number | 0-100 pt                     |                                                               |
+| `offset`  | number | 0-200 pt                     | **Must be non-negative** — negative values corrupt the file   |
+| `angle`   | number | 0-359 degrees                | Direction the shadow falls (135 = bottom-right, 270 = upward) |
+| `opacity` | number | 0.0-1.0                      | Use this for transparency, never encode in color string       |
+
+To cast a shadow upward (e.g. on a footer bar), use `angle: 270` with a positive offset — do **not** use a negative offset.
+
+**Note**: Gradient fills are not natively supported. Use a gradient image as a background instead.
+
+---
+
+## Images
+
+### Image Sources
+
+```javascript
+// From file path
+slide.addImage({ path: "images/chart.png", x: 1, y: 1, w: 5, h: 3 })
+
+// From URL
+slide.addImage({ path: "https://example.com/image.jpg", x: 1, y: 1, w: 5, h: 3 })
+
+// From base64 (faster, no file I/O)
+slide.addImage({ data: "image/png;base64,iVBORw0KGgo...", x: 1, y: 1, w: 5, h: 3 })
+```
+
+### Image Options
+
+```javascript
+slide.addImage({
+  path: "image.png",
+  x: 1,
+  y: 1,
+  w: 5,
+  h: 3,
+  rotate: 45, // 0-359 degrees
+  rounding: true, // Circular crop
+  transparency: 50, // 0-100
+  flipH: true, // Horizontal flip
+  flipV: false, // Vertical flip
+  altText: "Description", // Accessibility
+  hyperlink: { url: "https://example.com" },
+})
+```
+
+### Image Sizing Modes
+
+```javascript
+// Contain - fit inside, preserve ratio
+{ sizing: { type: 'contain', w: 4, h: 3 } }
+
+// Cover - fill area, preserve ratio (may crop)
+{ sizing: { type: 'cover', w: 4, h: 3 } }
+
+// Crop - cut specific portion
+{ sizing: { type: 'crop', x: 0.5, y: 0.5, w: 2, h: 2 } }
+```
+
+### Calculate Dimensions (preserve aspect ratio)
+
+```javascript
+const origWidth = 1978,
+  origHeight = 923,
+  maxHeight = 3.0
+const calcWidth = maxHeight * (origWidth / origHeight)
+const centerX = (10 - calcWidth) / 2
+
+slide.addImage({ path: "image.png", x: centerX, y: 1.2, w: calcWidth, h: maxHeight })
+```
+
+### Supported Formats
+
+- **Standard**: PNG, JPG, GIF (animated GIFs work in Microsoft 365)
+- **SVG**: Works in modern PowerPoint/Microsoft 365
+
+---
+
+## Icons
+
+Use react-icons to generate SVG icons, then rasterize to PNG for universal compatibility.
+
+### Setup
+
+```javascript
+const React = require("react")
+const ReactDOMServer = require("react-dom/server")
+const sharp = require("sharp")
+const { FaCheckCircle, FaChartLine } = require("react-icons/fa")
+
+function renderIconSvg(IconComponent, color = "#000000", size = 256) {
+  return ReactDOMServer.renderToStaticMarkup(React.createElement(IconComponent, { color, size: String(size) }))
+}
+
+async function iconToBase64Png(IconComponent, color, size = 256) {
+  const svg = renderIconSvg(IconComponent, color, size)
+  const pngBuffer = await sharp(Buffer.from(svg)).png().toBuffer()
+  return "image/png;base64," + pngBuffer.toString("base64")
+}
+```
+
+### Add Icon to Slide
+
+```javascript
+const iconData = await iconToBase64Png(FaCheckCircle, "#4472C4", 256)
+
+slide.addImage({
+  data: iconData,
+  x: 1,
+  y: 1,
+  w: 0.5,
+  h: 0.5, // Size in inches
+})
+```
+
+**Note**: Use size 256 or higher for crisp icons. The size parameter controls the rasterization resolution, not the display size on the slide (which is set by `w` and `h` in inches).
+
+### Icon Libraries
+
+Install: `npm install -g react-icons react react-dom sharp`
+
+Popular icon sets in react-icons:
+
+- `react-icons/fa` - Font Awesome
+- `react-icons/md` - Material Design
+- `react-icons/hi` - Heroicons
+- `react-icons/bi` - Bootstrap Icons
+
+---
+
+## Slide Backgrounds
+
+```javascript
+// Solid color
+slide.background = { color: "F1F1F1" }
+
+// Color with transparency
+slide.background = { color: "FF3399", transparency: 50 }
+
+// Image from URL
+slide.background = { path: "https://example.com/bg.jpg" }
+
+// Image from base64
+slide.background = { data: "image/png;base64,iVBORw0KGgo..." }
+```
+
+---
+
+## Tables
+
+```javascript
+slide.addTable(
+  [
+    ["Header 1", "Header 2"],
+    ["Cell 1", "Cell 2"],
+  ],
+  {
+    x: 1,
+    y: 1,
+    w: 8,
+    h: 2,
+    border: { pt: 1, color: "999999" },
+    fill: { color: "F1F1F1" },
+  },
+)
+
+// Advanced with merged cells
+let tableData = [
+  [{ text: "Header", options: { fill: { color: "6699CC" }, color: "FFFFFF", bold: true } }, "Cell"],
+  [{ text: "Merged", options: { colspan: 2 } }],
+]
+slide.addTable(tableData, { x: 1, y: 3.5, w: 8, colW: [4, 4] })
+```
+
+---
+
+## Charts
+
+```javascript
+// Bar chart
+slide.addChart(
+  pres.charts.BAR,
+  [
+    {
+      name: "Sales",
+      labels: ["Q1", "Q2", "Q3", "Q4"],
+      values: [4500, 5500, 6200, 7100],
+    },
+  ],
+  {
+    x: 0.5,
+    y: 0.6,
+    w: 6,
+    h: 3,
+    barDir: "col",
+    showTitle: true,
+    title: "Quarterly Sales",
+  },
+)
+
+// Line chart
+slide.addChart(
+  pres.charts.LINE,
+  [
+    {
+      name: "Temp",
+      labels: ["Jan", "Feb", "Mar"],
+      values: [32, 35, 42],
+    },
+  ],
+  { x: 0.5, y: 4, w: 6, h: 3, lineSize: 3, lineSmooth: true },
+)
+
+// Pie chart
+slide.addChart(
+  pres.charts.PIE,
+  [
+    {
+      name: "Share",
+      labels: ["A", "B", "Other"],
+      values: [35, 45, 20],
+    },
+  ],
+  { x: 7, y: 1, w: 5, h: 4, showPercent: true },
+)
+```
+
+### Better-Looking Charts
+
+Default charts look dated. Apply these options for a modern, clean appearance:
+
+```javascript
+slide.addChart(pres.charts.BAR, chartData, {
+  x: 0.5,
+  y: 1,
+  w: 9,
+  h: 4,
+  barDir: "col",
+
+  // Custom colors (match your presentation palette)
+  chartColors: ["0D9488", "14B8A6", "5EEAD4"],
+
+  // Clean background
+  chartArea: { fill: { color: "FFFFFF" }, roundedCorners: true },
+
+  // Muted axis labels
+  catAxisLabelColor: "64748B",
+  valAxisLabelColor: "64748B",
+
+  // Subtle grid (value axis only)
+  valGridLine: { color: "E2E8F0", size: 0.5 },
+  catGridLine: { style: "none" },
+
+  // Data labels on bars
+  showValue: true,
+  dataLabelPosition: "outEnd",
+  dataLabelColor: "1E293B",
+
+  // Hide legend for single series
+  showLegend: false,
+})
+```
+
+**Key styling options:**
+
+- `chartColors: [...]` - hex colors for series/segments
+- `chartArea: { fill, border, roundedCorners }` - chart background
+- `catGridLine/valGridLine: { color, style, size }` - grid lines (`style: "none"` to hide)
+- `lineSmooth: true` - curved lines (line charts)
+- `legendPos: "r"` - legend position: "b", "t", "l", "r", "tr"
+
+---
+
+## Slide Masters
+
+```javascript
+pres.defineSlideMaster({
+  title: "TITLE_SLIDE",
+  background: { color: "283A5E" },
+  objects: [
+    {
+      placeholder: { options: { name: "title", type: "title", x: 1, y: 2, w: 8, h: 2 } },
+    },
+  ],
+})
+
+let titleSlide = pres.addSlide({ masterName: "TITLE_SLIDE" })
+titleSlide.addText("My Title", { placeholder: "title" })
+```
+
+---
+
+## Common Pitfalls
+
+⚠️ These issues cause file corruption, visual bugs, or broken output. Avoid them.
+
+1. **NEVER use "#" with hex colors** - causes file corruption
+
+   ```javascript
+   color: "FF0000" // ✅ CORRECT
+   color: "#FF0000" // ❌ WRONG
+   ```
+
+2. **NEVER encode opacity in hex color strings** - 8-char colors (e.g., `"00000020"`) corrupt the file. Use the `opacity` property instead.
+
+   ```javascript
+   shadow: { type: "outer", blur: 6, offset: 2, color: "00000020" }          // ❌ CORRUPTS FILE
+   shadow: { type: "outer", blur: 6, offset: 2, color: "000000", opacity: 0.12 }  // ✅ CORRECT
+   ```
+
+3. **Use `bullet: true`** - NEVER unicode symbols like "•" (creates double bullets)
+
+4. **Use `breakLine: true`** between array items or text runs together
+
+5. **Avoid `lineSpacing` with bullets** - causes excessive gaps; use `paraSpaceAfter` instead
+
+6. **Each presentation needs fresh instance** - don't reuse `pptxgen()` objects
+
+7. **NEVER reuse option objects across calls** - PptxGenJS mutates objects in-place (e.g. converting shadow values to EMU). Sharing one object between multiple calls corrupts the second shape.
+
+   ```javascript
+   const shadow = { type: "outer", blur: 6, offset: 2, color: "000000", opacity: 0.15 };
+   slide.addShape(pres.shapes.RECTANGLE, { shadow, ... });  // ❌ second call gets already-converted values
+   slide.addShape(pres.shapes.RECTANGLE, { shadow, ... });
+
+   const makeShadow = () => ({ type: "outer", blur: 6, offset: 2, color: "000000", opacity: 0.15 });
+   slide.addShape(pres.shapes.RECTANGLE, { shadow: makeShadow(), ... });  // ✅ fresh object each time
+   slide.addShape(pres.shapes.RECTANGLE, { shadow: makeShadow(), ... });
+   ```
+
+8. **Don't use `ROUNDED_RECTANGLE` with accent borders** - rectangular overlay bars won't cover rounded corners. Use `RECTANGLE` instead.
+
+   ```javascript
+   // ❌ WRONG: Accent bar doesn't cover rounded corners
+   slide.addShape(pres.shapes.ROUNDED_RECTANGLE, { x: 1, y: 1, w: 3, h: 1.5, fill: { color: "FFFFFF" } })
+   slide.addShape(pres.shapes.RECTANGLE, { x: 1, y: 1, w: 0.08, h: 1.5, fill: { color: "0891B2" } })
+
+   // ✅ CORRECT: Use RECTANGLE for clean alignment
+   slide.addShape(pres.shapes.RECTANGLE, { x: 1, y: 1, w: 3, h: 1.5, fill: { color: "FFFFFF" } })
+   slide.addShape(pres.shapes.RECTANGLE, { x: 1, y: 1, w: 0.08, h: 1.5, fill: { color: "0891B2" } })
+   ```
+
+---
+
+## Quick Reference
+
+- **Shapes**: RECTANGLE, OVAL, LINE, ROUNDED_RECTANGLE
+- **Charts**: BAR, LINE, PIE, DOUGHNUT, SCATTER, BUBBLE, RADAR
+- **Layouts**: LAYOUT_16x9 (10"×5.625"), LAYOUT_16x10, LAYOUT_4x3, LAYOUT_WIDE
+- **Alignment**: "left", "center", "right"
+- **Chart data labels**: "outEnd", "inEnd", "center"

package/.plcode/skill/experimental/document-pptx/scripts/add_slide.py

@@ -0,0 +1,195 @@
+"""Add a new slide to an unpacked PPTX directory.
+
+Usage: python add_slide.py <unpacked_dir> <source>
+
+The source can be:
+  - A slide file (e.g., slide2.xml) - duplicates the slide
+  - A layout file (e.g., slideLayout2.xml) - creates from layout
+
+Examples:
+    python add_slide.py unpacked/ slide2.xml
+    # Duplicates slide2, creates slide5.xml
+
+    python add_slide.py unpacked/ slideLayout2.xml
+    # Creates slide5.xml from slideLayout2.xml
+
+To see available layouts: ls unpacked/ppt/slideLayouts/
+
+Prints the <p:sldId> element to add to presentation.xml.
+"""
+
+import re
+import shutil
+import sys
+from pathlib import Path
+
+
+def get_next_slide_number(slides_dir: Path) -> int:
+    existing = [int(m.group(1)) for f in slides_dir.glob("slide*.xml")
+                if (m := re.match(r"slide(\d+)\.xml", f.name))]
+    return max(existing) + 1 if existing else 1
+
+
+def create_slide_from_layout(unpacked_dir: Path, layout_file: str) -> None:
+    slides_dir = unpacked_dir / "ppt" / "slides"
+    rels_dir = slides_dir / "_rels"
+    layouts_dir = unpacked_dir / "ppt" / "slideLayouts"
+
+    layout_path = layouts_dir / layout_file
+    if not layout_path.exists():
+        print(f"Error: {layout_path} not found", file=sys.stderr)
+        sys.exit(1)
+
+    next_num = get_next_slide_number(slides_dir)
+    dest = f"slide{next_num}.xml"
+    dest_slide = slides_dir / dest
+    dest_rels = rels_dir / f"{dest}.rels"
+
+    slide_xml = '''<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<p:sld xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main" xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships" xmlns:p="http://schemas.openxmlformats.org/presentationml/2006/main">
+  <p:cSld>
+    <p:spTree>
+      <p:nvGrpSpPr>
+        <p:cNvPr id="1" name=""/>
+        <p:cNvGrpSpPr/>
+        <p:nvPr/>
+      </p:nvGrpSpPr>
+      <p:grpSpPr>
+        <a:xfrm>
+          <a:off x="0" y="0"/>
+          <a:ext cx="0" cy="0"/>
+          <a:chOff x="0" y="0"/>
+          <a:chExt cx="0" cy="0"/>
+        </a:xfrm>
+      </p:grpSpPr>
+    </p:spTree>
+  </p:cSld>
+  <p:clrMapOvr>
+    <a:masterClrMapping/>
+  </p:clrMapOvr>
+</p:sld>'''
+    dest_slide.write_text(slide_xml, encoding="utf-8")
+
+    rels_dir.mkdir(exist_ok=True)
+    rels_xml = f'''<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">
+  <Relationship Id="rId1" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/slideLayout" Target="../slideLayouts/{layout_file}"/>
+</Relationships>'''
+    dest_rels.write_text(rels_xml, encoding="utf-8")
+
+    _add_to_content_types(unpacked_dir, dest)
+
+    rid = _add_to_presentation_rels(unpacked_dir, dest)
+
+    next_slide_id = _get_next_slide_id(unpacked_dir)
+
+    print(f"Created {dest} from {layout_file}")
+    print(f'Add to presentation.xml <p:sldIdLst>: <p:sldId id="{next_slide_id}" r:id="{rid}"/>')
+
+
+def duplicate_slide(unpacked_dir: Path, source: str) -> None:
+    slides_dir = unpacked_dir / "ppt" / "slides"
+    rels_dir = slides_dir / "_rels"
+
+    source_slide = slides_dir / source
+
+    if not source_slide.exists():
+        print(f"Error: {source_slide} not found", file=sys.stderr)
+        sys.exit(1)
+
+    next_num = get_next_slide_number(slides_dir)
+    dest = f"slide{next_num}.xml"
+    dest_slide = slides_dir / dest
+
+    source_rels = rels_dir / f"{source}.rels"
+    dest_rels = rels_dir / f"{dest}.rels"
+
+    shutil.copy2(source_slide, dest_slide)
+
+    if source_rels.exists():
+        shutil.copy2(source_rels, dest_rels)
+
+        rels_content = dest_rels.read_text(encoding="utf-8")
+        rels_content = re.sub(
+            r'\s*<Relationship[^>]*Type="[^"]*notesSlide"[^>]*/>\s*',
+            "\n",
+            rels_content,
+        )
+        dest_rels.write_text(rels_content, encoding="utf-8")
+
+    _add_to_content_types(unpacked_dir, dest)
+
+    rid = _add_to_presentation_rels(unpacked_dir, dest)
+
+    next_slide_id = _get_next_slide_id(unpacked_dir)
+
+    print(f"Created {dest} from {source}")
+    print(f'Add to presentation.xml <p:sldIdLst>: <p:sldId id="{next_slide_id}" r:id="{rid}"/>')
+
+
+def _add_to_content_types(unpacked_dir: Path, dest: str) -> None:
+    content_types_path = unpacked_dir / "[Content_Types].xml"
+    content_types = content_types_path.read_text(encoding="utf-8")
+
+    new_override = f'<Override PartName="/ppt/slides/{dest}" ContentType="application/vnd.openxmlformats-officedocument.presentationml.slide+xml"/>'
+
+    if f"/ppt/slides/{dest}" not in content_types:
+        content_types = content_types.replace("</Types>", f"  {new_override}\n</Types>")
+        content_types_path.write_text(content_types, encoding="utf-8")
+
+
+def _add_to_presentation_rels(unpacked_dir: Path, dest: str) -> str:
+    pres_rels_path = unpacked_dir / "ppt" / "_rels" / "presentation.xml.rels"
+    pres_rels = pres_rels_path.read_text(encoding="utf-8")
+
+    rids = [int(m) for m in re.findall(r'Id="rId(\d+)"', pres_rels)]
+    next_rid = max(rids) + 1 if rids else 1
+    rid = f"rId{next_rid}"
+
+    new_rel = f'<Relationship Id="{rid}" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/slide" Target="slides/{dest}"/>'
+
+    if f"slides/{dest}" not in pres_rels:
+        pres_rels = pres_rels.replace("</Relationships>", f"  {new_rel}\n</Relationships>")
+        pres_rels_path.write_text(pres_rels, encoding="utf-8")
+
+    return rid
+
+
+def _get_next_slide_id(unpacked_dir: Path) -> int:
+    pres_path = unpacked_dir / "ppt" / "presentation.xml"
+    pres_content = pres_path.read_text(encoding="utf-8")
+    slide_ids = [int(m) for m in re.findall(r'<p:sldId[^>]*id="(\d+)"', pres_content)]
+    return max(slide_ids) + 1 if slide_ids else 256
+
+
+def parse_source(source: str) -> tuple[str, str | None]:
+    if source.startswith("slideLayout") and source.endswith(".xml"):
+        return ("layout", source)
+
+    return ("slide", None)
+
+
+if __name__ == "__main__":
+    if len(sys.argv) != 3:
+        print("Usage: python add_slide.py <unpacked_dir> <source>", file=sys.stderr)
+        print("", file=sys.stderr)
+        print("Source can be:", file=sys.stderr)
+        print("  slide2.xml        - duplicate an existing slide", file=sys.stderr)
+        print("  slideLayout2.xml  - create from a layout template", file=sys.stderr)
+        print("", file=sys.stderr)
+        print("To see available layouts: ls <unpacked_dir>/ppt/slideLayouts/", file=sys.stderr)
+        sys.exit(1)
+
+    unpacked_dir = Path(sys.argv[1])
+    source = sys.argv[2]
+
+    if not unpacked_dir.exists():
+        print(f"Error: {unpacked_dir} not found", file=sys.stderr)
+        sys.exit(1)
+
+    source_type, layout_file = parse_source(source)
+
+    if source_type == "layout" and layout_file is not None:
+        create_slide_from_layout(unpacked_dir, layout_file)
+    else:
+        duplicate_slide(unpacked_dir, source)