@erclx/canon 4.0.0 → 4.1.0

package/claude/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "canon",
   "description": "Automated governance, versioning, and discovery tools for Claude Code.",
-  "version": "4.0.0",
+  "version": "4.1.0",
   "author": {
     "name": "Eric Le",
     "url": "https://github.com/erclx"

package/docs/agents/commands.md

@@ -22,7 +22,7 @@ Full help: `canon <command> --help`. Behavior notes for the install and sync ver
 | `canon indexes regen`       | Regenerate `index.md` files from sibling frontmatter                                                                                                                  |
 | `canon docs [topic]`        | Emit toolkit reference docs (`list`, or a topic by name)                                                                                                              |
 | `canon design render`       | Render `.claude/DESIGN.md` tokens to HTML and CSS                                                                                                                     |
-| `canon slides render`       | Render a `.claude/SLIDES.md` source into a PowerPoint deck                                                                                                            |
+| `canon slides render`       | Render a `.claude/SLIDES.md` source into a PowerPoint deck, reporting any unrecognized layout name on stderr                                                          |
 | `canon slides list`         | List the available slide layouts (`--json` for the catalog)                                                                                                           |
 | `canon feedback`            | Write toolkit feedback from stdin to `.claude/review/feedback/`, or open a GitHub issue with `--github`                                                               |
 | `canon transcripts <url>`   | Fetch a YouTube transcript with metadata frontmatter (needs `yt-dlp`)                                                                                                 |

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@erclx/canon",
   "type": "module",
-  "version": "4.0.0",
+  "version": "4.1.0",
   "description": "Infrastructure and quality tooling for developer workflows",
   "license": "MIT",
   "bin": {

package/src/commands/slides.ts

@@ -48,6 +48,13 @@ export function register(program: Command): void {
           process.stderr.write(
             `${GREY}│${NC} ${GREEN}✓${NC} ${result.slideCount} slides\n${GREY}│${NC} ${GREEN}✓${NC} ${result.pptxPath}\n`,
           )
+          const validNames = LAYOUTS.map((layout) => layout.name).join(', ')
+          for (const { value, slideNumbers } of result.unrecognizedLayouts) {
+            const noun = slideNumbers.length === 1 ? 'slide' : 'slides'
+            process.stderr.write(
+              `${GREY}│${NC} ${RED}✗${NC} unrecognized layout "${value}" on ${noun} ${slideNumbers.join(', ')}. Valid layouts: ${validNames}\n`,
+            )
+          }
           if (result.mirrorPath) {
             process.stderr.write(
               `${GREY}│${NC} ${GREEN}✓${NC} mirrored to ${result.mirrorPath}\n`,

package/src/slides/layouts.ts

@@ -32,6 +32,12 @@ export const LAYOUTS: LayoutInfo[] = [
   { name: 'quote', description: 'Large pull quote with attribution' },
 ]
 
+const LAYOUT_NAMES = new Set(LAYOUTS.map((layout) => layout.name))
+
+export function isKnownLayout(name: string): boolean {
+  return LAYOUT_NAMES.has(name)
+}
+
 const W = 13.333
 const H = 7.5
 const MX = 0.7

package/src/slides/render.ts

@@ -4,16 +4,23 @@ import PptxGenJS from 'pptxgenjs'
 import {
   addFooter,
   type DeckNav,
+  isKnownLayout,
   renderDeckSlide,
   renderToc,
 } from '@/slides/layouts'
 import { type Deck, parseSlidesDoc } from '@/slides/parse'
 import { buildTheme, type Variant } from '@/slides/styles'
 
+export interface UnrecognizedLayout {
+  value: string
+  slideNumbers: number[]
+}
+
 export interface RenderResult {
   pptxPath: string
   mirrorPath?: string
   slideCount: number
+  unrecognizedLayouts: UnrecognizedLayout[]
 }
 
 export interface RenderOptions {
@@ -35,16 +42,22 @@ export async function renderSlidesDoc(
   if (deck.meta.title) pptx.title = deck.meta.title
 
   const nav = buildNav(deck)
-  for (const slide of deck.slides) {
+  const unrecognizedSlideNumbers = new Map<string, number[]>()
+  deck.slides.forEach((slide, index) => {
     const target = pptx.addSlide()
     target.background = { color: theme.background }
+    if (!isKnownLayout(slide.layout)) {
+      const slideNumbers = unrecognizedSlideNumbers.get(slide.layout) ?? []
+      slideNumbers.push(index + 1)
+      unrecognizedSlideNumbers.set(slide.layout, slideNumbers)
+    }
     if (slide.layout === 'toc') {
       renderToc(target, slide, theme, nav)
     } else {
       renderDeckSlide(target, slide, theme)
     }
     addFooter(target, slide, theme, nav)
-  }
+  })
 
   mkdirSync(outDir, { recursive: true })
   const fileName = outputName(sourcePath)
@@ -54,7 +67,16 @@ export async function renderSlidesDoc(
   const mirrorPath = options.mirror
     ? mirrorDeck(pptxPath, options.mirror, fileName)
     : undefined
-  return { pptxPath, mirrorPath, slideCount: deck.slides.length }
+  const unrecognizedLayouts = Array.from(
+    unrecognizedSlideNumbers,
+    ([value, slideNumbers]) => ({ value, slideNumbers }),
+  )
+  return {
+    pptxPath,
+    mirrorPath,
+    slideCount: deck.slides.length,
+    unrecognizedLayouts,
+  }
 }
 
 function mirrorDeck(