manim-simplex 0.2.0__tar.gz

manim_simplex-0.2.0/.gitignore

@@ -0,0 +1,30 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+
+# Build artifacts
+build/
+dist/
+*.egg-info/
+.eggs/
+
+# uv
+.venv/
+
+# Tool caches
+.ruff_cache/
+.pytest_cache/
+.basedpyright/
+.mypy_cache/
+
+# Manim output
+media/
+# manim-slides output (rooted, so tests/slides/ stays tracked)
+/slides/
+
+# Editors
+.idea/
+.vscode/
+*.swp
+.DS_Store

manim_simplex-0.2.0/.pre-commit-config.yaml

@@ -0,0 +1,66 @@
+ci:
+  autofix_commit_msg: |
+    chore(fmt): auto fixes from pre-commit.com hooks
+
+    for more information, see https://pre-commit.ci
+  autoupdate_commit_msg: 'chore(deps): pre-commit autoupdate'
+
+default_stages:
+- pre-commit
+- pre-push
+
+repos:
+- repo: https://github.com/pre-commit/pre-commit-hooks
+  rev: v6.0.0
+  hooks:
+  - id: check-yaml
+  - id: check-toml
+  - id: end-of-file-fixer
+  - id: trailing-whitespace
+  - id: check-merge-conflict
+  - id: check-added-large-files
+    args: [--maxkb=512]
+  - id: mixed-line-ending
+    args: [--fix=lf]
+
+- repo: https://github.com/macisamuele/language-formatters-pre-commit-hooks
+  rev: v2.16.0
+  hooks:
+  - id: pretty-format-yaml
+    args: [--autofix]
+  - id: pretty-format-toml
+    exclude: ^(uv\.lock|poetry\.lock)$
+    args: [--autofix, --trailing-commas]
+
+- repo: https://github.com/astral-sh/ruff-pre-commit
+  rev: v0.15.12
+  hooks:
+  - id: ruff
+    args: [--fix]
+  - id: ruff-format
+
+- repo: https://github.com/pre-commit/mirrors-mypy
+  rev: v1.20.2
+  hooks:
+  - id: mypy
+    additional_dependencies: [types-requests, types-setuptools]
+    args: [--ignore-missing-imports]
+    files: ^src/
+
+- repo: https://github.com/codespell-project/codespell
+  rev: v2.4.2
+  hooks:
+  - id: codespell
+    additional_dependencies:
+    - tomli
+    args: [--ignore-words-list=manim, mobjects, mobject]
+    exclude: ^(uv\.lock|.*\.svg)$
+
+- repo: local
+  hooks:
+  - id: github-issues
+    name: GitHub issues link check
+    description: Check issues (and PR) links are matching number.
+    entry: python .github/scripts/check_github_issues.py
+    language: system
+    types: [markdown]

manim_simplex-0.2.0/.python-version

@@ -0,0 +1 @@
+3.13

manim_simplex-0.2.0/CHANGELOG.md

@@ -0,0 +1,114 @@
+# Changelog
+
+All notable changes to `manim-simplex` are documented here.
+The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/);
+this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.2.0] - 2026-05-24
+
+### Added
+
+- `TexPage` mobject — fixed-width minipage helper. Width is configurable
+  via the ``width_cm`` kwarg (default 20.0) or by overriding the class
+  attribute on a subclass. Replaces the old ``Definition`` mobject; the
+  hardcoded minipage literal no longer appears in presets or
+  tests.
+- `Region.split(axis, k)` — divide a region into ``k`` sub-regions
+  along a cardinal direction. Each piece keeps the perpendicular extent
+  and gets ``1/k`` of the axis extent; pieces are returned in the
+  direction of ``axis``. Their union equals the original region.
+- `Spacing.header_buff` / `Spacing.footer_buff` — chrome gap distances
+  exposed on the theme so they can be tuned deck-wide without editing
+  ``make_chrome``.
+- `simplex.manifest` module — Pydantic models (`DeckManifest`, `MainSlide`,
+  `Subsection`) that define the cross-package contract between the plugin
+  and the `simplex` web builder. The web builder now imports the schema
+  from the plugin rather than redefining it locally.
+- `simplex.section` module — `SimplexSectionType` enum promoted to the
+  package root (previously `simplex.engine.section_types`). Manim-free so
+  the web builder and CLI can use it without paying for a Manim import.
+- `simplex.mobjects` subpackage — `Node`, `Edge`, `ArrayMob`, `ArrayEntry`,
+  `ArrayPointer` promoted from `simplex.slides.components` to a top-level
+  mobjects package, matching Manim's own `manim.mobject.*` convention.
+- `simplex.slides.Chrome` NamedTuple — pure factory return type combining
+  the canvas mobjects dict and the body region.
+- `simplex.engine.HighlightResult` dataclass — typed return for
+  `highlight_code_lines`, iterable so the existing `self.play(*result)`
+  pattern still works.
+- `py.typed` marker — downstream `pyright`/`mypy` users now get type
+  information for the `simplex` namespace.
+- `examples/` directory — runnable demo scenes (`hello_slide.py`,
+  `theme_demo.py`, `glyph_map_demo.py`) used as documentation and CI
+  fixtures.
+- `.pre-commit-config.yaml` — ruff, ruff-format, codespell, and standard
+  whitespace/yaml/toml hygiene hooks.
+- CHANGELOG.md.
+- CI: `manim plugins -l` discovery smoke test alongside the existing
+  import smoke.
+
+### Changed
+
+- **BREAKING:** ``Region.place`` now takes a Manim **direction vector**
+  (``UP``, ``DR``, ``ORIGIN``, …) instead of a string anchor name. The
+  same applies to the ``_anchor_point`` helper. Migrate
+  ``region.place(mob, "top", buff=…)`` → ``region.place(mob, UP, buff=…)``.
+- **BREAKING:** ``make_chrome`` no longer accepts a ``page=`` parameter.
+  Slide numbering is presentation chrome and is now driven by the
+  RevealJS template (toggle via ``[web]`` overrides in ``deck.toml``)
+  so it survives without being baked into each frame.
+- **BREAKING:** ``BodyText`` is removed. Plain ``manim.Tex`` carries the
+  theme's body font size through ``apply_theme_defaults`` — call sites
+  rewrite ``BodyText(...)`` to ``Tex(...)``.
+- **BREAKING:** ``Definition`` is renamed to ``TexPage`` (and no longer
+  reads ``theme.latex.environments["definition"]``).
+- ``BaseSlide`` auto-promotion now pretty-prints the class name into a
+  space-separated label (``DFSLecture`` → ``"DFS Lecture"``,
+  ``ImplementBFSSlide`` → ``"Implement BFS Slide"``). The class name
+  itself is unchanged.
+- **BREAKING:** Python floor raised to **3.13** (was a transitional 3.14
+  in the Phase 3 split commit). 3.13 is a long-term-supportable floor
+  with much wider availability for lecture authors.
+- **BREAKING:** `simplex.engine.section_types` → `simplex.section`.
+- **BREAKING:** `simplex.slides.components.{graph, array}` →
+  `simplex.mobjects.{graph, array}`.
+- **BREAKING:** `simplex.engine.transforms` is split into
+  `simplex.engine.glyph_map` (`TransformByGlyphMap`) and
+  `simplex.engine.ghost_fade` (`GhostSlideFade`). The combined module is
+  removed.
+- `BaseSlide.next_slide()` still auto-promotes the first bare call to
+  a main slide (named after the scene class), but no longer emits a
+  `UserWarning`. Passing `name=` on the first call still works and only
+  changes the slide's name; the section type is `MAIN` either way.
+- **BREAKING:** `make_chrome` no longer mutates its `Region` argument.
+  It returns a `Chrome(mobjects, body_region)` NamedTuple. Callers do
+  `chrome = make_chrome(...); self.add_to_canvas(**chrome.mobjects);
+  self.region = chrome.body_region` (or destructure).
+- **BREAKING:** `highlight_code_lines` returns `HighlightResult` (a
+  frozen dataclass with `.fade` and `.indicate`) instead of the prior
+  tuple-or-AnimationGroup union. `*result` unpacks back into the
+  previous tuple form for callers that prefer it.
+- Exit animation overrides are now stored in a `WeakKeyDictionary`
+  registry rather than monkey-patched onto the `Mobject` as a
+  `_simplex_exit` attribute. The public API (`set_exit_animation`,
+  `exit_for`, `Remove`) is unchanged.
+- The exit-defaults registry is now wrapped in a singleton with
+  threading.Lock-guarded lazy init, removing the module-level mutable
+  global.
+
+### Removed
+
+- ``BodyText`` mobject. Use ``manim.Tex`` (body size + color come from
+  ``apply_theme_defaults``) or ``Caption`` for smaller annotations.
+- ``Definition`` mobject. Replaced by ``TexPage`` (see Added/Changed).
+- ``make_chrome(..., page=…)`` parameter and the corresponding ``page``
+  entry in ``Chrome.mobjects``. Slide numbering moves to the web layer.
+- ``LatexProfile.environments["definition"]`` entries from
+  ``DASTIMATOR_DARK`` and ``ACADEMIC_LIGHT``: ``TexPage`` is now the
+  single owner of the ``{minipage}{<width>cm}`` literal.
+- `simplex.engine.section_types` module (replaced by `simplex.section`).
+- `simplex.slides.components` subpackage (replaced by `simplex.mobjects`).
+- `simplex.engine.transforms` module (split — see Changed).
+- `UserWarning` on the first bare `BaseSlide.next_slide()` call. Auto-
+  promotion stays (named after the class), just silently.

manim_simplex-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Shlomi Perles
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

manim_simplex-0.2.0/PKG-INFO

@@ -0,0 +1,214 @@
+Metadata-Version: 2.4
+Name: manim-simplex
+Version: 0.2.0
+Summary: Manim plugin: theme tokens, mobjects, slide hierarchy, deck manifest schema.
+Project-URL: Changelog, https://github.com/shlomi-perles/manim-simplex/blob/main/CHANGELOG.md
+Project-URL: Homepage, https://github.com/shlomi-perles/manim-simplex
+Project-URL: Issues, https://github.com/shlomi-perles/manim-simplex/issues
+Project-URL: Repository, https://github.com/shlomi-perles/manim-simplex
+Author: Shlomi Perles
+License-Expression: MIT
+License-File: LICENSE
+Keywords: animation,computer-science,education,lecture,manim,manim-slides,math,presentation
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Education
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Education
+Classifier: Topic :: Multimedia :: Graphics
+Classifier: Topic :: Multimedia :: Video
+Classifier: Topic :: Scientific/Engineering :: Visualization
+Classifier: Typing :: Typed
+Requires-Python: >=3.13
+Requires-Dist: manim-slides>=5.1.7
+Requires-Dist: manim>=0.20.1
+Requires-Dist: pydantic>=2.7
+Requires-Dist: pygments>=2.18
+Description-Content-Type: text/markdown
+
+# manim-simplex
+
+[![PyPI version](https://img.shields.io/pypi/v/manim-simplex.svg)](https://pypi.org/project/manim-simplex/)
+[![Python](https://img.shields.io/pypi/pyversions/manim-simplex.svg)](https://pypi.org/project/manim-simplex/)
+[![License](https://img.shields.io/pypi/l/manim-simplex.svg)](https://github.com/shlomi-perles/manim-simplex/blob/main/LICENSE)
+
+The Manim plugin half of [Simplex](https://github.com/shlomi-perles/simplex):
+theme tokens, reusable mobjects, slide hierarchy, deck manifest schema,
+and the `manim.plugins` entry-point. Distributed on PyPI as
+`manim-simplex`.
+
+The lecture-portal platform (CLI, deck discovery, render orchestration,
+web builder) lives in the sibling [`simplex`](https://github.com/shlomi-perles/simplex)
+package; both contribute modules to the shared PEP 420 `simplex/`
+namespace.
+
+## What ships here
+
+| Module | Contents |
+|---|---|
+| `simplex.plugin` | `activate()` -- the `manim.plugins` entry-point. Applies the active theme to `manim.config`. |
+| `simplex.section` | `SimplexSectionType` enum -- the slide-hierarchy strings written into Manim's sections JSON. Manim-free. |
+| `simplex.manifest` | `DeckManifest`, `MainSlide`, `Subsection` Pydantic models -- the cross-package contract consumed by the `simplex` web builder. Manim-free. |
+| `simplex.theme` | `Theme`, `Palette`, `Typography`, `Spacing`, `Motion`, `LatexProfile`, `WebPalette`, `active_theme`, `get_active_theme`, `presets`, `render_web_css`. |
+| `simplex.engine` | Animation primitives -- `Region`, `Remove`, `clear_scene`, `exit_for`, `register_exit`, `set_exit_animation`, `HighlightResult`, `apply_theme_defaults`, plus the `glyph_map`, `ghost_fade`, `dynamics`, `geometry`, `code`, `text`, `scaling`, `debug` submodules. |
+| `simplex.mobjects` | `Node`, `Edge`, `ArrayMob`, `ArrayEntry`, `ArrayPointer`, `OutlineProgressBar`. |
+| `simplex.slides` | `BaseSlide`, `OutlineScene`, `OutlinePart`, `Chrome`, `make_chrome`. |
+
+## Install
+
+```bash
+uv add manim-simplex
+# or
+pip install manim-simplex
+```
+
+System dependencies (texlive, ffmpeg, cairo, pango) are the same as
+Manim's -- see the [Manim install guide](https://docs.manim.community/en/stable/installation.html).
+
+## Quick start
+
+```ini
+# decks/<your-deck>/manim.cfg
+[CLI]
+plugins = simplex
+save_sections = True
+```
+
+```python
+from manim import MathTex
+from simplex.slides import BaseSlide, make_chrome
+from simplex.theme import presets
+
+class Hello(BaseSlide):
+    def setup(self) -> None:
+        super().setup()
+        chrome = make_chrome(presets.DASTIMATOR_DARK, self.region, header="Hello")
+        self.add_to_canvas(**chrome.mobjects)
+        self.region = chrome.body_region
+
+    def construct(self) -> None:
+        from manim import ORIGIN, Write
+        eq = MathTex(r"e^{i\pi} + 1 = 0")
+        self.region.place(eq, ORIGIN)
+        self.play(Write(eq))
+        self.next_slide(name="Hello")
+```
+
+```bash
+uv run manim-slides render path/to/your_deck/scene.py Hello
+```
+
+## Slide hierarchy
+
+`BaseSlide.next_slide` writes a `SimplexSectionType` value into Manim's
+native section JSON. The web builder reconciles that with manim-slides'
+`PresentationConfig` to build a main/sub tree.
+
+- `self.next_slide(name="Title")` -> **MAIN** slide named `"Title"`.
+- `self.next_slide()` as the *first* call -> **MAIN** slide
+  auto-named after the scene class with PascalCase boundaries spaced
+  out (``DFSLecture`` → ``"DFS Lecture"``; no warning).
+- `self.next_slide()` after a named main -> **SUB** slide.
+- `self.next_slide(..., loop=True)` -> the `LOOP` variant.
+- `self.next_slide(..., section_type="simplex.main.skip")` -> explicit
+  override always wins.
+
+## Outline slides
+
+`OutlineScene` composes typed `OutlinePart` objects into an animated
+`BaseSlide` outline. Each part owns already-built Manim mobjects for its
+feature title, compact label, and optional visual. Progress dots are
+positioned with `self.region.linspace(RIGHT, n)` defaults, so edge
+margins and inter-dot gaps are equal.
+
+```python
+from manim import Circle, Square, Tex
+from simplex.engine.text import Caption
+from simplex.slides import OutlinePart, OutlineScene
+
+class Outline(OutlineScene):
+    def __init__(self, **kwargs):
+        super().__init__(
+            parts=[
+                OutlinePart(Tex("Research Question"), Caption("Question"), Circle()),
+                OutlinePart(Tex("Algorithms"), Caption("Algorithms"), Square()),
+            ],
+            **kwargs,
+        )
+```
+
+## Theme
+
+Themes are frozen Pydantic models -- the same instance produces:
+
+1. Manim defaults (via `apply_theme_defaults`, called by the plugin).
+2. A `TexTemplate` (via `LatexProfile.as_tex_template`).
+3. CSS variables for the web portal + RevealJS HTML (via
+   `render_web_css(theme.web_palette)`).
+4. The `darcula` Pygments style (registered by the plugin).
+
+Switch themes per-scope with `active_theme`:
+
+```python
+from simplex.theme import presets
+from simplex.theme.context import active_theme
+
+from manim import Tex
+
+with active_theme(presets.ACADEMIC_LIGHT):
+    label = Tex("This Tex picks up the academic light palette.")
+```
+
+## Cross-package contract
+
+`manim-simplex` owns the manifest schema; `simplex` imports it:
+
+```python
+from simplex.manifest import DeckManifest, MainSlide, Subsection
+```
+
+When the schema bumps `schema_version`, the web builder hard-fails on
+unknown versions with a pointer at the `manim-simplex` upgrade. This
+keeps the two repos honest about their contract.
+
+## Why a separate distribution?
+
+The plugin surface (mobjects + theme + entry-point + manifest schema)
+is reusable independently of the lecture-portal pipeline. Splitting
+them lets the plugin be a thin dependency for users who want to render
+slides without pulling in Typer, watchfiles, Jinja, and the web
+builder stack.
+
+Python's PEP 420 implicit namespace packages merge the two distributions
+at import time. Neither wheel ships `src/simplex/__init__.py`, so
+`from simplex.engine import Remove` resolves regardless of which wheel
+contributed the module.
+
+## Development
+
+Requires Python 3.13+ and [uv](https://docs.astral.sh/uv/).
+
+```bash
+git clone https://github.com/shlomi-perles/manim-simplex.git
+cd manim-simplex
+uv sync --all-extras
+uv run pre-commit install
+uv run pytest -q
+uv run ruff check .
+uv run basedpyright
+```
+
+Examples under `examples/` are runnable demo scenes; they double as
+documentation and CI smoke tests:
+
+```bash
+uv run manim -pql examples/hello_slide.py HelloSlide
+```
+
+## License
+
+MIT.

manim_simplex-0.2.0/README.md

@@ -0,0 +1,182 @@
+# manim-simplex
+
+[![PyPI version](https://img.shields.io/pypi/v/manim-simplex.svg)](https://pypi.org/project/manim-simplex/)
+[![Python](https://img.shields.io/pypi/pyversions/manim-simplex.svg)](https://pypi.org/project/manim-simplex/)
+[![License](https://img.shields.io/pypi/l/manim-simplex.svg)](https://github.com/shlomi-perles/manim-simplex/blob/main/LICENSE)
+
+The Manim plugin half of [Simplex](https://github.com/shlomi-perles/simplex):
+theme tokens, reusable mobjects, slide hierarchy, deck manifest schema,
+and the `manim.plugins` entry-point. Distributed on PyPI as
+`manim-simplex`.
+
+The lecture-portal platform (CLI, deck discovery, render orchestration,
+web builder) lives in the sibling [`simplex`](https://github.com/shlomi-perles/simplex)
+package; both contribute modules to the shared PEP 420 `simplex/`
+namespace.
+
+## What ships here
+
+| Module | Contents |
+|---|---|
+| `simplex.plugin` | `activate()` -- the `manim.plugins` entry-point. Applies the active theme to `manim.config`. |
+| `simplex.section` | `SimplexSectionType` enum -- the slide-hierarchy strings written into Manim's sections JSON. Manim-free. |
+| `simplex.manifest` | `DeckManifest`, `MainSlide`, `Subsection` Pydantic models -- the cross-package contract consumed by the `simplex` web builder. Manim-free. |
+| `simplex.theme` | `Theme`, `Palette`, `Typography`, `Spacing`, `Motion`, `LatexProfile`, `WebPalette`, `active_theme`, `get_active_theme`, `presets`, `render_web_css`. |
+| `simplex.engine` | Animation primitives -- `Region`, `Remove`, `clear_scene`, `exit_for`, `register_exit`, `set_exit_animation`, `HighlightResult`, `apply_theme_defaults`, plus the `glyph_map`, `ghost_fade`, `dynamics`, `geometry`, `code`, `text`, `scaling`, `debug` submodules. |
+| `simplex.mobjects` | `Node`, `Edge`, `ArrayMob`, `ArrayEntry`, `ArrayPointer`, `OutlineProgressBar`. |
+| `simplex.slides` | `BaseSlide`, `OutlineScene`, `OutlinePart`, `Chrome`, `make_chrome`. |
+
+## Install
+
+```bash
+uv add manim-simplex
+# or
+pip install manim-simplex
+```
+
+System dependencies (texlive, ffmpeg, cairo, pango) are the same as
+Manim's -- see the [Manim install guide](https://docs.manim.community/en/stable/installation.html).
+
+## Quick start
+
+```ini
+# decks/<your-deck>/manim.cfg
+[CLI]
+plugins = simplex
+save_sections = True
+```
+
+```python
+from manim import MathTex
+from simplex.slides import BaseSlide, make_chrome
+from simplex.theme import presets
+
+class Hello(BaseSlide):
+    def setup(self) -> None:
+        super().setup()
+        chrome = make_chrome(presets.DASTIMATOR_DARK, self.region, header="Hello")
+        self.add_to_canvas(**chrome.mobjects)
+        self.region = chrome.body_region
+
+    def construct(self) -> None:
+        from manim import ORIGIN, Write
+        eq = MathTex(r"e^{i\pi} + 1 = 0")
+        self.region.place(eq, ORIGIN)
+        self.play(Write(eq))
+        self.next_slide(name="Hello")
+```
+
+```bash
+uv run manim-slides render path/to/your_deck/scene.py Hello
+```
+
+## Slide hierarchy
+
+`BaseSlide.next_slide` writes a `SimplexSectionType` value into Manim's
+native section JSON. The web builder reconciles that with manim-slides'
+`PresentationConfig` to build a main/sub tree.
+
+- `self.next_slide(name="Title")` -> **MAIN** slide named `"Title"`.
+- `self.next_slide()` as the *first* call -> **MAIN** slide
+  auto-named after the scene class with PascalCase boundaries spaced
+  out (``DFSLecture`` → ``"DFS Lecture"``; no warning).
+- `self.next_slide()` after a named main -> **SUB** slide.
+- `self.next_slide(..., loop=True)` -> the `LOOP` variant.
+- `self.next_slide(..., section_type="simplex.main.skip")` -> explicit
+  override always wins.
+
+## Outline slides
+
+`OutlineScene` composes typed `OutlinePart` objects into an animated
+`BaseSlide` outline. Each part owns already-built Manim mobjects for its
+feature title, compact label, and optional visual. Progress dots are
+positioned with `self.region.linspace(RIGHT, n)` defaults, so edge
+margins and inter-dot gaps are equal.
+
+```python
+from manim import Circle, Square, Tex
+from simplex.engine.text import Caption
+from simplex.slides import OutlinePart, OutlineScene
+
+class Outline(OutlineScene):
+    def __init__(self, **kwargs):
+        super().__init__(
+            parts=[
+                OutlinePart(Tex("Research Question"), Caption("Question"), Circle()),
+                OutlinePart(Tex("Algorithms"), Caption("Algorithms"), Square()),
+            ],
+            **kwargs,
+        )
+```
+
+## Theme
+
+Themes are frozen Pydantic models -- the same instance produces:
+
+1. Manim defaults (via `apply_theme_defaults`, called by the plugin).
+2. A `TexTemplate` (via `LatexProfile.as_tex_template`).
+3. CSS variables for the web portal + RevealJS HTML (via
+   `render_web_css(theme.web_palette)`).
+4. The `darcula` Pygments style (registered by the plugin).
+
+Switch themes per-scope with `active_theme`:
+
+```python
+from simplex.theme import presets
+from simplex.theme.context import active_theme
+
+from manim import Tex
+
+with active_theme(presets.ACADEMIC_LIGHT):
+    label = Tex("This Tex picks up the academic light palette.")
+```
+
+## Cross-package contract
+
+`manim-simplex` owns the manifest schema; `simplex` imports it:
+
+```python
+from simplex.manifest import DeckManifest, MainSlide, Subsection
+```
+
+When the schema bumps `schema_version`, the web builder hard-fails on
+unknown versions with a pointer at the `manim-simplex` upgrade. This
+keeps the two repos honest about their contract.
+
+## Why a separate distribution?
+
+The plugin surface (mobjects + theme + entry-point + manifest schema)
+is reusable independently of the lecture-portal pipeline. Splitting
+them lets the plugin be a thin dependency for users who want to render
+slides without pulling in Typer, watchfiles, Jinja, and the web
+builder stack.
+
+Python's PEP 420 implicit namespace packages merge the two distributions
+at import time. Neither wheel ships `src/simplex/__init__.py`, so
+`from simplex.engine import Remove` resolves regardless of which wheel
+contributed the module.
+
+## Development
+
+Requires Python 3.13+ and [uv](https://docs.astral.sh/uv/).
+
+```bash
+git clone https://github.com/shlomi-perles/manim-simplex.git
+cd manim-simplex
+uv sync --all-extras
+uv run pre-commit install
+uv run pytest -q
+uv run ruff check .
+uv run basedpyright
+```
+
+Examples under `examples/` are runnable demo scenes; they double as
+documentation and CI smoke tests:
+
+```bash
+uv run manim -pql examples/hello_slide.py HelloSlide
+```
+
+## License
+
+MIT.

manim_simplex-0.2.0/examples/README.md

@@ -0,0 +1,33 @@
+# Examples
+
+Runnable demo scenes that double as integration smoke tests.
+
+Each scene is intentionally small (single concept, ~30 LOC) and uses the
+`manim-simplex` public API as a downstream user would.
+
+## Running
+
+From the repo root with the dev environment synced:
+
+```bash
+uv run manim -pql examples/hello_slide.py HelloSlide
+uv run manim -pql examples/theme_demo.py ThemeDemo
+uv run manim -pql examples/glyph_map_demo.py GlyphMapDemo
+```
+
+The `-pql` flag previews at low quality. Use `-pqh` for 1080p, `-qk` for
+4K render-only.
+
+## With manim-slides
+
+To render as a slide deck (uses the `Slide` base class):
+
+```bash
+uv run manim-slides render examples/hello_slide.py HelloSlide
+uv run manim-slides present HelloSlide
+```
+
+The plugin auto-activates via the `manim.plugins` entry-point as long as
+the deck's `manim.cfg` declares `plugins = simplex`. For these examples
+we keep a tiny `manim.cfg` next to them so they render with the Simplex
+theme out of the box.