streamtex 0.7.78__tar.gz → 0.7.80__tar.gz

{streamtex-0.7.78/streamtex.egg-info → streamtex-0.7.80}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: streamtex
-Version: 0.7.78
+Version: 0.7.80
 Summary: AI-powered content framework for Streamlit — create presentations, courses, and web-books with Claude or Cursor, no coding required.
 Author-email: Nicolas Guelfi <nicolas.guelfi@laposte.net>
 License-Expression: BUSL-1.1
@@ -38,6 +38,7 @@ Requires-Dist: streamlit-mermaid>=0.3.0
 Requires-Dist: mermaid-py>=0.5.0
 Requires-Dist: python-dotenv>=1.2.1
 Requires-Dist: Pillow>=10.0
+Requires-Dist: pyyaml>=6.0
 Provides-Extra: inspector
 Requires-Dist: streamlit-ace>=0.1.1; extra == "inspector"
 Provides-Extra: cli

{streamtex-0.7.78 → streamtex-0.7.80}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "streamtex"
-version = "0.7.78"
+version = "0.7.80"
 description = "AI-powered content framework for Streamlit — create presentations, courses, and web-books with Claude or Cursor, no coding required."
 readme = "README.md"
 requires-python = ">=3.11"
@@ -43,6 +43,7 @@ dependencies = [
     "mermaid-py>=0.5.0",
     "python-dotenv>=1.2.1",
     "Pillow>=10.0",
+    "pyyaml>=6.0",
 ]
 
 [project.scripts]

{streamtex-0.7.78 → streamtex-0.7.80}/streamtex/__init__.py

@@ -178,6 +178,14 @@ try:
         st_refs, BibRefs, generate_bib_stubs,
     )
 
+    # Glossary: hover definitions, CSS only (#12)
+    from .glossary import (
+        GlossaryConfig, GlossaryRegistry,
+        set_glossary_config, get_glossary_config,
+        get_glossary_registry, reset_glossary_registry,
+        load_glossary, gloss, st_glossary,
+    )
+
     # Link behavior configuration
     from .link_config import LinkConfig, set_link_config, get_link_config
 
@@ -290,6 +298,8 @@ __all__ = [
     "ProfileConfig",
     "ProjectBlockRegistry",
     "ProjectMeta",
+    "GlossaryConfig",
+    "GlossaryRegistry",
     "ReuseArchitectureError",
     "SLIDE_CONTAINER",
     "SLIDE_NOTE_STYLE",
@@ -320,6 +330,8 @@ __all__ = [
     "exec_static",
     "export_bibtex",
     "export_pdf",
+    "load_glossary",
+    "reset_glossary_registry",
     "extract_frames",
     "extract_math",
     "extract_tikz",
@@ -329,6 +341,9 @@ __all__ = [
     "get_ai_image_config",
     "get_available_models",
     "get_bib_config",
+    "get_glossary_config",
+    "get_glossary_registry",
+    "gloss",
     "get_bib_registry",
     "get_block_helper_config",
     "get_block_spacing",
@@ -381,6 +396,7 @@ __all__ = [
     "save_image_version",
     "set_ai_image_config",
     "set_bib_config",
+    "set_glossary_config",
     "set_block_helper_config",
     "set_block_spacing",
     "set_gsheet_config",
@@ -402,6 +418,7 @@ __all__ = [
     "st_audio",
     "st_bar_chart",
     "st_bibliography",
+    "st_glossary",
     "st_block",
     "st_book",
     "st_br",

{streamtex-0.7.78 → streamtex-0.7.80}/streamtex/bib.py

@@ -1065,7 +1065,9 @@ def st_bibliography(*, style=None, title: str = "References",
                     toc_lvl: Optional[str] = None,
                     only_cited: bool = True,
                     format: Optional[BibFormat] = None,
-                    label_style: Optional[CitationStyle] = None) -> None:
+                    label_style: Optional[CitationStyle] = None,
+                    chunk_size: Optional[int] = None,
+                    slide_break_config=None) -> None:
     """Render the full bibliography list.
 
     Args:
@@ -1082,9 +1084,16 @@ def st_bibliography(*, style=None, title: str = "References",
             shows inline: ``(Dart et al., 2013)`` in AUTHOR_YEAR, ``[3]`` in
             NUMERIC and SUPERSCRIPT. Pass ``CitationStyle.NUMERIC`` to keep
             ``[N]`` beside author-year citations.
+        chunk_size: When set, at most this many entries per slide: a
+            ``st_slide_break()`` separates the chunks, each repeats the title
+            with its rank (``References (2/5)``) and the numbering goes on.
+            The TOC gets the plain title once. ``None``: one list (#23).
+        slide_break_config: The ``SlideBreakConfig`` of the breaks between
+            chunks (default: the global one).
     """
     from .container import st_block
     from .export import _render
+    from .slide import st_slide_break
     from .space import st_space
     from .styles import StxStyles
     from .write import st_write
@@ -1099,28 +1108,39 @@ def st_bibliography(*, style=None, title: str = "References",
     # Sort
     entries = _sort_entries(entries, cfg.sort_by)
 
-    # Title
-    ts = title_style or (StxStyles.big + StxStyles.bold)
-    if title:
-        st_write(ts, title, toc_lvl=toc_lvl)
-        st_space("v", 2)
+    if chunk_size is not None and chunk_size < 1:
+        raise ValueError(f"st_bibliography: chunk_size must be at least 1, not {chunk_size}")
+    size = chunk_size or len(entries)
+    chunks = [entries[i:i + size] for i in range(0, len(entries), size)]
 
-    # Build inline CSS from Style objects
+    ts = title_style or (StxStyles.big + StxStyles.bold)
     entry_css = entry_style.css if entry_style else ""
     number_css = number_style.css if number_style else "font-weight:bold;"
     labels = label_style or cfg.citation_style
 
-    # Entries
-    with st_block(style):
-        for i, entry in enumerate(entries):
-            formatted = format_entry(entry, fmt, number=0)
-            num_html = f'<span style="{number_css}">{_entry_label(entry, i + 1, labels)}</span> '
-            anchor_id = f"bib-{entry.key}"
-            _render(
-                f'<p id="{anchor_id}" style="margin-bottom:10px;text-indent:-2.5em;'
-                f'padding-left:2.5em;line-height:1.6;overflow-wrap:anywhere;{entry_css}">'
-                f'{num_html}{formatted}</p>'
-            )
+    first = 1
+    for k, chunk in enumerate(chunks, 1):
+        if k > 1:
+            st_slide_break(marker_label=f"{title or 'References'} {k}/{len(chunks)}",
+                           config=slide_break_config)
+        if title:
+            rank = f" ({k}/{len(chunks)})" if len(chunks) > 1 else ""
+            if k == 1:
+                st_write(ts, title + rank, toc_lvl=toc_lvl, label=title if toc_lvl else "")
+            else:
+                st_write(ts, title + rank)
+            st_space("v", 2)
+        with st_block(style):
+            for i, entry in enumerate(chunk, first):
+                formatted = format_entry(entry, fmt, number=0)
+                num_html = f'<span style="{number_css}">{_entry_label(entry, i, labels)}</span> '
+                anchor_id = f"bib-{entry.key}"
+                _render(
+                    f'<p id="{anchor_id}" style="margin-bottom:10px;text-indent:-2.5em;'
+                    f'padding-left:2.5em;line-height:1.6;overflow-wrap:anywhere;{entry_css}">'
+                    f'{num_html}{formatted}</p>'
+                )
+        first += len(chunk)
 
 
 def _entry_label(entry: BibEntry, number: int, style: CitationStyle) -> str:

{streamtex-0.7.78 → streamtex-0.7.80}/streamtex/book.py

@@ -85,6 +85,7 @@ from .spacing import (
     resolve_block_spacing,
     set_active_profile,
 )
+from .stage import STAGE_KEY
 from .styles import Style
 from .toc import NumberingMode, TOCConfig, reset_toc_registry, toc_entries
 from .utils import inject_link_preview_scaffold
@@ -536,6 +537,7 @@ def _offer_export_downloads(html: str, base_name: str,
                             doc_version=_cache.get("doc_version", ""),
                             lib_version=_cache.get("lib_version", ""),
                             notice=rules["notice"],
+                            stage=st.session_state.get(STAGE_KEY),
                         )
                         # Apply custom title override
                         if enrich_title:
@@ -726,24 +728,44 @@ def _resolve_sidebar_max_level(toc_config: TOCConfig, paginated: bool) -> int |
     return 1 if paginated else 2
 
 
-def _setup_bibliography(bib_sources, bib_config):
-    """Load bibliography sources and set config (called at start of st_book)."""
+def _setup_bibliography(bib_sources, bib_config, glossary_sources=None, glossary_config=None):
+    """Load bibliography and glossary sources and set config (called at start of st_book).
+
+    The ``@glossary`` entries of a bibliography source go to the glossary, so
+    they never take a citation number (#12).
+    """
     from .bib import get_bib_registry, load_bib, reset_bib_registry, set_bib_config
+    from .glossary import (
+        get_glossary_registry,
+        is_glossary,
+        load_glossary,
+        reset_glossary_registry,
+        set_glossary_config,
+    )
 
     reset_bib_registry()
+    reset_glossary_registry()
 
     if bib_config is not None:
         set_bib_config(bib_config)
+    if glossary_config is not None:
+        set_glossary_config(glossary_config)
 
-    if bib_sources:
-        registry = get_bib_registry()
-        for source_path in bib_sources:
-            try:
-                entries = load_bib(source_path)
-                registry.register_many(entries)
-                logger.debug(f"Loaded {len(entries)} bib entries from {source_path}")
-            except Exception as e:
-                logger.warning(f"Failed to load bibliography from {source_path}: {e}")
+    registry = get_bib_registry()
+    glossary = get_glossary_registry()
+    for source_path in bib_sources or []:
+        try:
+            entries = load_bib(source_path)
+            registry.register_many([e for e in entries if not is_glossary(e)])
+            glossary.register_many([e for e in entries if is_glossary(e)])
+            logger.debug(f"Loaded {len(entries)} bib entries from {source_path}")
+        except Exception as e:
+            logger.warning(f"Failed to load bibliography from {source_path}: {e}")
+    for source_path in glossary_sources or []:
+        try:
+            glossary.register_many(load_glossary(source_path))
+        except Exception as e:
+            logger.warning(f"Failed to load glossary from {source_path}: {e}")
 
 
 def _inject_bib_preview_if_enabled():
@@ -779,7 +801,9 @@ def _st_book_impl(module_list, toc_config: TOCConfig = None, marker_config: Mark
             lang: str | None = None,
             html_export_zoom: int = 0,
             notice=None,
-            printable: bool | PrintConfig = True):
+            printable: bool | PrintConfig = True,
+            glossary_sources=None, glossary_config=None,
+            stage=(1920, 1080)):
     """Generates a web page e-book from a list of block modules.
 
     :param separator: Optional module with a build() function, rendered between each block.
@@ -811,6 +835,15 @@ def _st_book_impl(module_list, toc_config: TOCConfig = None, marker_config: Mark
     :param banner: Optional BannerConfig for full banner customisation (overrides banner_color).
     :param bib_sources: Optional list of paths to .bib, .json, .ris, or .csl-json files.
     :param bib_config: Optional BibConfig to configure bibliography formatting.
+    :param glossary_sources: Optional list of glossary files for ``gloss()``:
+        ``.yaml``/``.yml``, ``.json`` (``{"LLM": "Large Language Model"}``)
+        or ``.bib`` (its ``@glossary`` entries). See ``streamtex.glossary``.
+    :param glossary_config: Optional GlossaryConfig (``strict=True``: an unknown key raises).
+    :param stage: Size of the stage (#105): ``(1920, 1080)`` (default),
+        ``[w, h]`` or ``"WxH"``. A link under the zoom controls, and in the
+        HTML export's sidebar, opens the document in a virtual screen of this
+        size scaled to the window, with black bands (``?stage=WxH`` in the
+        URL). ``False``: no stage.
     :param inspector: Optional InspectorConfig to enable the block inspector panel.
     :param page_width: Page width as % of browser width (default 90).
     :param zoom: Default zoom level as % (default 100).
@@ -862,6 +895,10 @@ def _st_book_impl(module_list, toc_config: TOCConfig = None, marker_config: Mark
     _block_kwargs = dict(block_kwargs or {})
     # --- Usage notice and print rules (#107): read by the panel and every export ---
     st.session_state[PRINT_KEY] = print_state(printable, notice, _block_kwargs.get("lang"))
+    # --- Stage size (#105): the sidebar link, and the HTML export's ---
+    from .stage import parse_stage, render_stage, requested_stage
+    _stage = parse_stage(stage)
+    st.session_state[STAGE_KEY] = _stage
     # --- Resolve PdfConfig from exports list if not provided directly ---
     if pdf_config is None and exports:
         for _ecfg in exports:
@@ -901,13 +938,19 @@ def _st_book_impl(module_list, toc_config: TOCConfig = None, marker_config: Mark
     if _warmup_mode:
         # The references first: an HTML export without them shows every
         # citation as [key?] and an empty bibliography.
-        _setup_bibliography(bib_sources, bib_config)
+        _setup_bibliography(bib_sources, bib_config, glossary_sources, glossary_config)
         _warmup_build_cache(module_list, toc_config, marker_config,
                             separator,
                             block_args=_block_args,
                             block_kwargs=_block_kwargs)
         return
 
+    # --- Stage (#105): this tab only frames the document, which has its own gate ---
+    _stage_now = requested_stage(_query_params(), _stage)
+    if _stage_now:
+        render_stage(_stage_now)
+        return
+
     # --- Password gate (env-driven, no-op locally) ---
     _password_gate()
 
@@ -936,7 +979,7 @@ def _st_book_impl(module_list, toc_config: TOCConfig = None, marker_config: Mark
         st.session_state[_STX_THEME_BG_KEY] = _bg
         st.session_state[_STX_THEME_TEXT_KEY] = _txt
     # --- Bibliography setup ---
-    _setup_bibliography(bib_sources, bib_config)
+    _setup_bibliography(bib_sources, bib_config, glossary_sources, glossary_config)
     # --- Presentation profiles ---
     default_profile = build_default_profile(page_width, zoom, paginate)
     user_profiles = presentation_profiles or []
@@ -1052,6 +1095,9 @@ def _st_book_impl(module_list, toc_config: TOCConfig = None, marker_config: Mark
                 )
             add_zoom_options(default_page_width=page_width, default_zoom=zoom,
                              container=_stx_settings)
+            if _stage:
+                from .stage import stage_link
+                stage_link(_query_params(), _stage, container=_stx_settings)
             add_wrap_all_option(container=_stx_settings)
             _stx_settings.divider()
             add_slide_break_options(container=_stx_settings)
@@ -1949,6 +1995,14 @@ _STX_PAGE_KEY = "_stx_current_page"
 _STX_INITIAL_MARKER_KEY = "_stx_initial_marker"
 
 
+def _query_params() -> dict:
+    """The URL's query parameters; ``{}`` outside a real script run (tests, headless)."""
+    try:
+        return st.query_params.to_dict()
+    except Exception:  # noqa: BLE001 -- no script context / mocked st
+        return {}
+
+
 def _initial_page_from_url(cache, total) -> tuple[int, int | None]:
     """Resolve the first page of the session from the URL (deep link).
 
@@ -2752,7 +2806,9 @@ def _build_page_cache(module_list, toc_config, marker_config, separator,
     # Persist cited bibliography keys so st_bibliography(only_cited=True) works
     # in paginated mode (cite() calls only run during cache build, not per-page).
     from .bib import get_bib_registry as _get_bib_registry
+    from .glossary import get_glossary_registry as _get_glossary_registry
     _bib_cited = list(_get_bib_registry()._cited)
+    _gloss_used = list(_get_glossary_registry()._used)          # st_glossary(only_used=True) (#12)
 
     st.session_state[_STX_CACHE_KEY] = {
         "hash": cache_hash,
@@ -2764,6 +2820,7 @@ def _build_page_cache(module_list, toc_config, marker_config, separator,
         "pages": pages,
         "search_index": search_index,
         "cited_keys": _bib_cited,
+        "glossary_used": _gloss_used,
         "doc_version": st.session_state.get("_stx_doc_version", ""),
         "lib_version": st.session_state.get("_stx_lib_version", ""),
         # Data files the blocks read through stx.load_*/watch_file during
@@ -3553,6 +3610,10 @@ def _paginated_book(module_list, toc_config, marker_config, separator,
         for _key in cache["cited_keys"]:
             if _key not in _bib_reg._cited:
                 _bib_reg._cited.append(_key)
+    if cache.get("glossary_used"):
+        from .glossary import get_glossary_registry as _get_gloss_reg
+        for _key in cache["glossary_used"]:
+            _get_gloss_reg().use(_key)
 
     # --- Banner — page titles for navigation labels ---
     page_titles = _get_page_titles(cache, total)
@@ -3783,6 +3844,7 @@ def _paginated_book(module_list, toc_config, marker_config, separator,
 BOOK_DEFAULT_KEYS = frozenset({
     "paginate", "paginate_by", "html_export_mode", "page_width", "zoom", "export", "export_title", "loading",
     "chrome_banner", "banner_color", "doc_version", "lang", "html_export_zoom",
+    "stage",                                                     # stage = [1920, 1080] (#105)
 })
 
 
@@ -3855,7 +3917,7 @@ _DEFAULTS_DOC = """Generates a web page e-book from a list of block modules.
     taken from ``[book.defaults]`` of the project's ``stx.toml`` when it
     declares them (``paginate``, ``page_width``, ``zoom``, ``export``,
     ``export_title``, ``loading``, ``chrome_banner``, ``banner_color``,
-    ``doc_version``, ``lang``), then from the defaults below.
+    ``doc_version``, ``lang``, ``stage``), then from the defaults below.
     ``doc_version="auto"`` reads ``[project].version`` of ``pyproject.toml``.
     """
 

{streamtex-0.7.78 → streamtex-0.7.80}/streamtex/cli/claude_cmd.py

@@ -286,6 +286,12 @@ def install_profile(claude_repo: str, profile: str, target: str) -> list[str]:
     if rendered and rendered not in installed:
         installed.append(rendered)
 
+    # The styles reference, generated from the code after the read-only copies (#6)
+    from .styles_cmd import refresh_reference
+    styles_ref = refresh_reference(target)
+    if styles_ref:
+        installed.append(styles_ref)
+
     return sorted(installed)
 
 
@@ -294,6 +300,7 @@ _GENERATED_PATHS = frozenset({
     os.path.join(".claude", ".stx-profile"),
     os.path.join(".claude", "CLAUDE.md"),   # profile text when the root CLAUDE.md is the user's
     os.path.join(".claude", "stx.lock"),    # project mode lock file
+    os.path.join(".claude", "references", "streamtex_styles_api.md"),   # stx styles dump (#6)
 })
 
 
@@ -1209,6 +1216,12 @@ def _update_single_target(
                     "Claude Code reads both files.[/dim]"
                 )
 
+    # The styles reference, regenerated when the version or its inputs changed (#6)
+    from .styles_cmd import refresh_reference
+    styles_ref = refresh_reference(target)
+    if styles_ref:
+        updated.append(styles_ref)
+
     if updated:
         console.print(f"\n[green]Updated {len(updated)} file(s).[/green]")
         for f in updated:

{streamtex-0.7.78 → streamtex-0.7.80}/streamtex/cli/claude_project.py

@@ -391,10 +391,13 @@ def sync_project(
 
     claude_dir = os.path.join(target, ".claude")
     if remove:
-        for rel in (os.path.join(".claude", ".stx-profile"), LOCK_PATH):
+        from .styles_cmd import REFERENCE
+        for rel in (os.path.join(".claude", ".stx-profile"), LOCK_PATH, REFERENCE):
             p = os.path.join(target, rel)
             if os.path.isfile(p):
+                os.chmod(p, 0o644)
                 os.remove(p)
+        _remove_empty_dirs(target, [REFERENCE])
         if lock and lock.claude_md and lock.claude_md_sha:
             p = os.path.join(target, lock.claude_md)
             if os.path.isfile(p) and sha256_file(p) == lock.claude_md_sha:
@@ -439,6 +442,10 @@ def sync_project(
         claude_md=claude_md, claude_md_sha=claude_md_sha, files=new_files,
     ))
     _ensure_gitignore(target, console)
+    # The styles reference, generated from the code (#6): never in the lock, never pruned
+    from .styles_cmd import refresh_reference
+    if refresh_reference(target):
+        console.print("  [green]✓[/green] .claude/references/streamtex_styles_api.md (generated)")
     return plan
 
 

{streamtex-0.7.78 → streamtex-0.7.80}/streamtex/cli/commands.py

@@ -64,6 +64,7 @@ from .run_cmd import run as stx_run
 from .screenshot_cmd import screenshot as stx_screenshot
 from .shortcuts import run_lint, run_test
 from .status_cmd import status as workspace_status
+from .styles_cmd import styles as styles_group
 from .sync_cmd import sync as stx_sync
 from .upgrade_cmd import upgrade as project_upgrade
 from .validate_cmd import validate as stx_validate
@@ -217,6 +218,7 @@ cli.add_command(ds_group, name="ds")
 cli.add_command(kit_group, name="kit")
 cli.add_command(artifact_group, name="artifact")
 cli.add_command(stx_validate, name="validate")
+cli.add_command(styles_group, name="styles")
 
 
 # --- Dev subgroup ----------------------------------------------------------

{streamtex-0.7.78 → streamtex-0.7.80}/streamtex/cli/export_cmd.py

@@ -263,6 +263,8 @@ def export_html(path, output, asset_mode, title, no_nav, theme_mode, theme_bg, t
         _cache_data = st.session_state.get(_book_mod._STX_CACHE_KEY) or {}
         from ..printing import get_print_state
         print_rules = get_print_state(st.session_state)       # notice, html_print (#107)
+        from ..stage import STAGE_KEY
+        stage_size = st.session_state.get(STAGE_KEY)            # the sidebar's stage link (#105)
 
     elapsed = time.time() - t0
 
@@ -343,6 +345,7 @@ def export_html(path, output, asset_mode, title, no_nav, theme_mode, theme_bg, t
             lib_version=_cache_data.get("lib_version", ""),
             page_nav=page_nav,
             notice=print_rules["notice"],
+            stage=stage_size,
         )
 
     if not no_nav and nav_data:

{streamtex-0.7.78 → streamtex-0.7.80}/streamtex/cli/release_cmd.py

@@ -27,6 +27,16 @@ def _passwords(cfg):
     return pw.load_file(pw.passwords_path(cfg.root))
 
 
+def _require_running(t, apps) -> None:
+    """The containers the command needs run, checked before an export: a wrong --target used to fail at the
+    first reload, after the export (all-trainings, 2026-10-29: 25 s, then "No such container: stx-static")."""
+    down = [a for a in sorted(set(apps)) if not t.running(a)]
+    if down:
+        hint = "start them (stx release local up) or " if t.kind == "local" else ""
+        raise ReleaseError(f"target {t.name}: the {' and '.join(down)} container(s) do not run — "
+                           f"{hint}choose another --target")
+
+
 _target = click.option("--target", "target", default=None, help="Target name in .stx-release.json "
                        "(default: its default_target).")
 
@@ -83,6 +93,7 @@ def publish_cmd(sites, groups, all_, target, allow_skew, html_env):
         raise ReleaseError("name the sites to publish, a --group, or --all for every site")
     cfg, state, t = _ctx(target)
     chosen = cfg.select(sites, groups)
+    _require_running(t, ["static" if f == "html" else "live" for s in chosen for f in s.faces])
     env = _html_env(html_env)
     release_name = build.require_committed(cfg.root)
     build.require_lock(cfg)
@@ -160,6 +171,7 @@ def limit_cmd(site, slide, labels, target, allow_skew, html_env):
     s = cfg.site(site)
     if "html" not in s.faces:
         raise ReleaseError(f"{s.site} has no HTML face: a slide limit applies to the HTML face")
+    _require_running(t, ["static"])
     _skew(cfg, t, allow_skew)
     if labels:
         names = [x.strip() for x in labels.split(",") if x.strip()]