Troubleshooting

Start from the observable failure, then verify the relevant package boundary, runtime, or OOXML layer before changing code.

Import Or Runtime Failures

Checks:

• Review Runtime And Package Support.
• Run pnpm run test:package.
• Inspect package.json exports and generated declarations.

Likely causes:

• A consumer is using a removed CommonJS or IIFE/global workflow.
• A consumer is deep-importing an internal source file.
• Generated declarations or package exports are stale.

OOXML Or PowerPoint Failures

Checks:

• Review OOXML Agent Context.
• Add or update a focused fixture.
• Run the relevant schema or regression test.

Likely causes:

• Emitted XML is structurally invalid.
• PowerPoint accepts a structure differently from the schema.
• A fix changed package parts or relationships without matching fixtures.

Docs Or API Drift

Checks:

• Run pnpm run docs:api.
• Run pnpm run docs:check.
• Compare generated API docs against package.json exports.

Likely causes:

• Public exports changed without regenerating docs.
• A hand-written page describes a planned API as current behavior.
• A generated reference page was edited instead of fixing the source types.