Release 1.1.0: inaugural power-pptx distribution with full documentation

[CodeHalwell]

Summary

This PR marks the inaugural 1.1.0 release of power-pptx on PyPI, bundling all features from Phases 1–10 of the fork's roadmap. The primary changes are:

1. Version bump to 1.1.0 (from 1.1.0.dev0)
2. Complete Sphinx documentation rebuild — every new module now ships with user-guide chapters and API-reference pages
3. Skill documentation for Claude — comprehensive reference guides covering space-aware authoring, design tokens, animations, effects, charts, composition, rendering, and more
4. Deprecation warning for shadow.inherit property (read/write now emit DeprecationWarning)
5. Documentation infrastructure updates — Sphinx 7.0+, RTD theme 2.0+, fail-on-warning enabled

The fork remains drop-in compatible with python-pptx 1.0.2 — all existing user code continues to work unchanged.

Key documentation additions

• User guides: space-aware-authoring.md, design.rst, effects.rst, animation.rst, transitions.rst, theme.rst, lint.rst, compose.rst, charts-advanced.rst, render.rst
• API references: New .rst files for design, animation, lint, theme, composition, rendering, SmartArt, and enum types
• Skill docs: .claude/skills/power-pptx/ with SKILL.md and detailed reference guides for each feature area
• Updated README with "What's new in the fork" section highlighting post-fork features

Code changes

• src/pptx/__init__.py: Version bumped to 1.1.0
• src/pptx/dml/effect.py: Added warnings import; shadow.inherit property now emits DeprecationWarning
• docs/conf.py: Completely rewritten for Sphinx 7.0+ with modern configuration structure
• HISTORY.rst: Added 1.1.0 release notes
• README.rst: Added "What's new in the fork" section
• pyproject.toml: Updated documentation URLs
• requirements-docs.txt: Updated to Sphinx 7.0+, sphinx-rtd-theme 2.0+
• .readthedocs.yaml: Enabled fail_on_warning
• .gitignore: Added /docs/_build/

Test notes

Existing tests pass; the deprecation warning in shadow.inherit is covered by updated test fixtures in tests/dml/test_effect.py. Documentation builds cleanly with no warnings.

refs #

https://claude.ai/code/session_018JjhN8F4kUpHnLp44WNWdH

[gemini-code-assist]

Code Review

This pull request introduces power-pptx, a fork of python-pptx that adds features like space-aware authoring, visual effects, animations, and a layout linter. The changes include extensive new documentation, reference guides, and API updates. Review feedback highlights several documentation inaccuracies, such as incorrect import paths for transitions, missing suffixes for line style enums, and the inclusion of an unsupported width parameter in thumbnail rendering examples. Additionally, the review identifies a hallucinated Presentation.lint() method and suggests optimizing linter calls in the skill definition to avoid redundant calculations.

[gemini-code-assist]

The import path for MSO_TRANSITION_TYPE is incorrect. According to the API documentation in docs/api/enum/MsoTransitionType.rst, it is located in pptx.enum.presentation, not pptx.enum.action.

Suggested change

	from pptx.enum.action import MSO_TRANSITION_TYPE
	from pptx.enum.presentation import MSO_TRANSITION_TYPE

[gemini-code-assist]

The enum names are missing the _STYLE suffix. Based on the API index in docs/api/enum/index.rst, the correct names are MSO_LINE_CAP_STYLE, MSO_LINE_COMPOUND_STYLE, and MSO_LINE_JOIN_STYLE.

Suggested change

	from pptx.enum.dml import MSO_LINE_CAP, MSO_LINE_COMPOUND, MSO_LINE_JOIN
	from pptx.enum.dml import MSO_LINE_CAP_STYLE, MSO_LINE_COMPOUND_STYLE, MSO_LINE_JOIN_STYLE

[gemini-code-assist]

These enum references should be updated to include the _STYLE suffix to match the corrected imports.

Suggested change

	line.cap = MSO_LINE_CAP.ROUND
	line.compound = MSO_LINE_COMPOUND.DOUBLE
	line.join = MSO_LINE_JOIN.BEVEL
	line.cap = MSO_LINE_CAP_STYLE.ROUND
	line.compound = MSO_LINE_COMPOUND_STYLE.DOUBLE
	line.join = MSO_LINE_JOIN_STYLE.BEVEL

[gemini-code-assist]

The Presentation.lint() method appears to be a hallucination in the documentation. Other reference guides (e.g., references/lint.md) state that users must iterate through slides manually to lint a whole deck. If this method is not implemented, this example will fail.

Suggested change

	deck_report = prs.lint() # slide-by-slide
	all_issues = []
	for slide in prs.slides:
	all_issues.extend(slide.lint().issues)

[gemini-code-assist]

The width parameter is used here, but references/render.md (line 41) explicitly states that "there's no width= knob" for the thumbnail renderer and suggests post-processing with Pillow instead.

Suggested change

	paths = prs.render_thumbnails(out_dir="thumbs", width=1280)
	paths = prs.render_thumbnails(out_dir="thumbs")

[gemini-code-assist]

The width parameter is used in this example, but it is documented as unsupported in references/render.md. This will likely cause a TypeError at runtime.

Suggested change

	return prs.render_thumbnails(out_dir=out_dir, width=1280)
	return prs.render_thumbnails(out_dir=out_dir)

[gemini-code-assist]

Calling slide.lint() twice is inefficient as it involves expensive font metric and geometry calculations. Since auto_fix() mutates the slide, a second pass is technically required to see the remaining issues, but the variable report from line 140 is currently unused. Consider capturing the results of the second call into the report variable for clarity or reusing the first report if only checking for non-fixable issues like TextOverflow.

Suggested change

	errors = [i for i in slide.lint().issues
	if i.severity.value == "error"]
	report = slide.lint()
	errors = [i for i in report.issues
	if i.severity.value == "error"]

[Copilot]

Pull request overview

This PR prepares the inaugural power-pptx 1.1.0 release by bumping the package version, adding ShadowFormat.inherit deprecation warnings, and rebuilding/expanding the Sphinx + Claude skill documentation and release notes for the fork.

Changes:

• Bump library version to 1.1.0 and update project metadata/URLs for the fork.
• Deprecate ShadowFormat.inherit (warn on read/write) and update unit tests accordingly.
• Modernize documentation infrastructure (Sphinx 7+, RTD theme 2+, fail-on-warning) and add extensive new user/API docs plus Claude skill references.

Reviewed changes

Copilot reviewed 54 out of 55 changed files in this pull request and generated 15 comments.

Show a summary per file

File	Description
tests/dml/test_effect.py	Updates tests to assert DeprecationWarning on ShadowFormat.inherit.
src/pptx/dml/effect.py	Emits DeprecationWarning on ShadowFormat.inherit get/set.
src/pptx/init.py	Version bump to 1.1.0.
requirements-docs.txt	Updates docs build deps to Sphinx 7+/RTD theme 2+.
pyproject.toml	Updates URLs to power-pptx repo/docs + adds Roadmap URL.
docs/user/transitions.rst	Adds transitions user guide chapter.
docs/user/theme.rst	Adds theme user guide chapter.
docs/user/render.rst	Adds slide thumbnail rendering user guide chapter.
docs/user/lint.rst	Adds linter user guide chapter.
docs/user/effects.rst	Adds effects user guide chapter.
docs/user/design.rst	Adds design-system user guide chapter.
docs/user/compose.rst	Adds composition user guide chapter.
docs/user/charts-advanced.rst	Adds advanced chart helpers user guide chapter.
docs/user/animation.rst	Adds animations user guide chapter.
docs/index.rst	Rebrands docs index, expands toctrees, updates feature list.
docs/conf.py	Modernizes Sphinx config and substitutions for the fork.
docs/api/theme.rst	Adds Theme API reference page (+ resolve_color).
docs/api/smart_art.rst	Adds SmartArt API reference page.
docs/api/slides.rst	Documents SlideTransition in slides API reference.
docs/api/render.rst	Adds render API reference page.
docs/api/lint.rst	Adds lint API reference page.
docs/api/enum/index.rst	Adds enum toctree entries for new enums.
docs/api/enum/PpAnimTrigger.rst	Adds enum API page for PP_ANIM_TRIGGER.
docs/api/enum/MsoTransitionType.rst	Adds enum API page for MSO_TRANSITION_TYPE.
docs/api/enum/MsoLineJoinStyle.rst	Adds enum API page for MSO_LINE_JOIN_STYLE.
docs/api/enum/MsoLineEndType.rst	Adds enum API page for MSO_LINE_END_TYPE.
docs/api/enum/MsoLineEndSize.rst	Adds enum API page for MSO_LINE_END_SIZE.
docs/api/enum/MsoLineCompoundStyle.rst	Adds enum API page for MSO_LINE_COMPOUND_STYLE.
docs/api/enum/MsoLineCapStyle.rst	Adds enum API page for MSO_LINE_CAP_STYLE.
docs/api/dml.rst	Expands DrawingML API docs (effects, alpha, line ends, etc.).
docs/api/design.rst	Adds design system API reference page.
docs/api/compose.rst	Adds composition API reference page.
docs/api/animation.rst	Adds animation API reference page.
ROADMAP.md	Marks documentation rebuild as complete; adds 1.1.0 readiness notes.
README.rst	Adds “What’s new in the fork” feature overview and updates docs text.
HISTORY.rst	Adds 1.1.0 release entry and reorganizes phase notes.
.readthedocs.yaml	Enables fail_on_warning for RTD builds.
.gitignore	Ignores /docs/_build/.
.claude/skills/power-pptx/references/transitions.md	Adds Claude reference doc for transitions.
.claude/skills/power-pptx/references/three-d.md	Adds Claude reference doc for 3D primitives.
.claude/skills/power-pptx/references/theme.md	Adds Claude reference doc for themes.
.claude/skills/power-pptx/references/tables.md	Adds Claude reference doc for tables + borders.
.claude/skills/power-pptx/references/space-aware-authoring.md	Adds Claude reference doc for space-aware authoring.
.claude/skills/power-pptx/references/smart-art.md	Adds Claude reference doc for SmartArt substitution.
.claude/skills/power-pptx/references/render.md	Adds Claude reference doc for thumbnail rendering.
.claude/skills/power-pptx/references/picture-effects.md	Adds Claude reference doc for picture effects + SVG.
.claude/skills/power-pptx/references/lint.md	Adds Claude reference doc for linting.
.claude/skills/power-pptx/references/end-to-end-deck.md	Adds full end-to-end Claude example deck script.
.claude/skills/power-pptx/references/effects.md	Adds Claude reference doc for effects.
.claude/skills/power-pptx/references/design.md	Adds Claude reference doc for design tokens/recipes/layout.
.claude/skills/power-pptx/references/compose.md	Adds Claude reference doc for composition/from_spec.
.claude/skills/power-pptx/references/charts.md	Adds Claude reference doc for chart palettes/layouts.
.claude/skills/power-pptx/references/basics.md	Adds Claude reference doc for core 1.0.2 API basics.
.claude/skills/power-pptx/references/animations.md	Adds Claude reference doc for animations.
.claude/skills/power-pptx/SKILL.md	Adds Claude skill manifest + reference index.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

The TextOverflow bullet claims the linter measures text extent using Pillow font metrics. In the current implementation (src/pptx/lint.py), _check_text_overflow uses a simple character/line-count heuristic and explicitly skips shapes with auto-size enabled; it does not use Pillow. The docs should be updated to reflect the current behavior/limitations (or the implementation changed to match the docs).

[Copilot]

The save-time hook example uses prs.lint_on_save, but that attribute/property doesn't exist anywhere in the codebase (no occurrences under src/). Either implement the save-time hook or remove/replace this section with a supported pattern (e.g., from_spec(..., lint="raise") or an explicit pre-save lint pass).

[Copilot]

This claims from_spec is "JSON-schema-validated". The current implementation validates via custom Python checks (e.g., _validate_spec_keys) and does not use a JSON Schema validator. Please reword this to avoid implying JSON Schema compatibility/support unless a real schema + validator is introduced.

[Copilot]

This example calls prs.render_thumbnails(..., width=1280), but the underlying API does not accept a width kwarg (see src/pptx/render.py:102). Please drop the width argument here, or implement width-resizing support if that's intended.

Suggested change

	return prs.render_thumbnails(out_dir=out_dir, width=1280)
	return prs.render_thumbnails(out_dir=out_dir)

[Copilot]

.. autoclass:: SlideAnimations() is not a valid object reference for autodoc; the parentheses will make Sphinx try to import an attribute literally named SlideAnimations() and emit a warning (which will fail the RTD build with fail_on_warning). Use the class name without parentheses (and add :members: if you expect method docs here).

Suggested change

	.. autoclass:: SlideAnimations()
	.. autoclass:: SlideAnimations

[Copilot]

The feature list says the linter can auto-fix "text overflow". In the current implementation, SlideLintReport.auto_fix() only nudges OffSlide shapes; TextOverflow is detected but not auto-fixed. Please adjust this bullet to avoid overstating auto-fix capabilities.

[Copilot]

prs.lint_on_save is referenced as a supported knob here, but that attribute/property doesn't exist anywhere under src/ (repo-wide search is empty). Either add the save-time hook implementation or remove this guidance so the reference docs don’t direct users to a non-existent API.

Suggested change

	- Replace `prs.lint_on_save = "raise"` with `"warn"` in production if
	you need decks to ship even with cosmetic warnings; keep `"raise"`
	in CI.
	- In production, run `prs.lint()` explicitly before saving: use
	`.auto_fix()` to repair what can be fixed automatically, then log or
	report any remaining warning-severity issues instead of failing the
	build. In CI, keep the stricter behavior and raise on residual
	errors.

[Copilot]

This reference says from_spec is JSON-schema-validated, but the implementation uses bespoke Python validation (no JSON Schema validator is used). Consider rephrasing to "validated" (and optionally link to the supported keys/values) unless you intend to publish and enforce an actual JSON Schema.

Suggested change

	spec is JSON-schema-validated before construction:
	spec is validated before construction:

[Copilot]

deck.lint_on_save = "raise" uses a lint_on_save attribute that isn't implemented anywhere in src/. Consider replacing this with an explicit lint pass (e.g. iterating slide.lint()), or from_spec(..., lint="raise") where applicable.

[Copilot]

The examples pass width=... into Presentation.render_thumbnails() / render_slide_thumbnails(), but the actual API only accepts out_dir, slide_indexes, soffice_bin, timeout, and return_bytes (see src/pptx/render.py:102). Please remove the width kwarg from the examples and, if you want to mention sizing, note that callers need to post-process the resulting PNGs.