texsmith 0.0.2.dev0__py3-none-any.whl

texsmith/fragments/bibliography/__init__.py

@@ -0,0 +1,65 @@
+from __future__ import annotations
+
+from collections.abc import Mapping
+from dataclasses import dataclass
+from pathlib import Path
+from typing import Any, ClassVar
+
+from texsmith.core.fragments.base import BaseFragment, FragmentPiece
+
+
+@dataclass(frozen=True)
+class BibliographyConfig:
+    has_citations: bool
+
+    @classmethod
+    def from_context(cls, context: Mapping[str, Any]) -> BibliographyConfig:
+        return cls(has_citations=bool(context.get("citations")))
+
+    def inject_into(self, context: dict[str, Any]) -> None:
+        context["ts_bibliography_enabled"] = self.has_citations
+
+
+class BibliographyFragment(BaseFragment[BibliographyConfig]):
+    name: ClassVar[str] = "ts-bibliography"
+    description: ClassVar[str] = (
+        "Bibliography helpers (packages + backmatter) loaded when citations are present."
+    )
+    pieces: ClassVar[list[FragmentPiece]] = [
+        FragmentPiece(
+            template_path=Path(__file__).with_name("ts-bibliography.jinja.tex"),
+            kind="inline",
+            slot="extra_packages",
+        ),
+        FragmentPiece(
+            template_path=Path(__file__).with_name("ts-bibliography-backmatter.jinja.tex"),
+            kind="inline",
+            slot="fragment_backmatter",
+        ),
+    ]
+    attributes: ClassVar[dict[str, Any]] = {}
+    config_cls: ClassVar[type[BibliographyConfig]] = BibliographyConfig
+    source: ClassVar[Path] = Path(__file__).with_name("ts-bibliography.jinja.tex")
+
+    def build_config(
+        self, context: Mapping[str, Any], overrides: Mapping[str, Any] | None = None
+    ) -> BibliographyConfig:
+        _ = overrides
+        return self.config_cls.from_context(context)
+
+    def inject(
+        self,
+        config: BibliographyConfig,
+        context: dict[str, Any],
+        overrides: Mapping[str, Any] | None = None,
+    ) -> None:
+        _ = overrides
+        config.inject_into(context)
+
+    def should_render(self, config: BibliographyConfig) -> bool:
+        return config.has_citations
+
+
+fragment = BibliographyFragment()
+
+__all__ = ["BibliographyConfig", "BibliographyFragment", "fragment"]

texsmith/fragments/bibliography/fragment.toml

@@ -0,0 +1,3 @@
+name = "ts-bibliography"
+description = "Conditional bibliography support (packages + backmatter)."
+entrypoint = "texsmith.fragments.bibliography:fragment"

texsmith/fragments/bibliography/ts-bibliography-backmatter.jinja.tex

@@ -0,0 +1,35 @@
+\BLOCK{ if citations }
+\BLOCK{ if bibliography_resource }
+\printbibliography
+\BLOCK{ else }
+\begin{thebibliography}{\VAR{citations|length}}
+\BLOCK{ for key in citations }
+\BLOCK{ set entry = bibliography_entries.get(key) }
+\bibitem{\VAR{key}}%
+\BLOCK{ if entry }
+\BLOCK{ set fields = entry['fields'] }
+\BLOCK{ set persons = entry['persons'] }
+\BLOCK{ set authors = persons.get('author', []) }
+\BLOCK{ if authors }
+\VAR{ authors | map(attribute='text') | join(', ') }
+\BLOCK{ endif }
+\BLOCK{ if fields.get('title') }
+\newblock \textit{\VAR{fields['title']}}
+\BLOCK{ endif }
+\BLOCK{ if fields.get('publisher') }
+\newblock \VAR{fields['publisher']}
+\BLOCK{ endif }
+\BLOCK{ if fields.get('year') }
+\newblock (\VAR{fields['year']})
+\BLOCK{ endif }
+\BLOCK{ if fields.get('url') }
+\newblock \url{\VAR{fields['url']}}
+\BLOCK{ endif }
+\par\smallskip
+\BLOCK{ else }
+Missing bibliography entry for \VAR{key}
+\BLOCK{ endif }
+\BLOCK{ endfor }
+\end{thebibliography}
+\BLOCK{ endif }
+\BLOCK{ endif }

texsmith/fragments/bibliography/ts-bibliography.jinja.tex

@@ -0,0 +1,10 @@
+\BLOCK{ if citations }
+\usepackage{csquotes}
+\BLOCK{ if bibliography_resource }
+\usepackage[
+  backend=biber,
+  style=\VAR{bibliography_style|default('numeric')},
+]{biblatex}
+\addbibresource{\VAR{bibliography_resource}}
+\BLOCK{ endif }
+\BLOCK{ endif }

texsmith/fragments/callouts/__init__.py

@@ -0,0 +1,88 @@
+from __future__ import annotations
+
+from collections.abc import Mapping
+from dataclasses import dataclass
+from pathlib import Path
+from typing import Any, ClassVar
+
+from texsmith.core.fragments.base import BaseFragment, FragmentPiece
+from texsmith.core.templates.manifest import TemplateAttributeSpec
+
+
+@dataclass(frozen=True)
+class CalloutsConfig:
+    style: str | None
+    uses_callouts: bool
+
+    @classmethod
+    def from_context(cls, context: Mapping[str, Any]) -> CalloutsConfig:
+        return cls(
+            style=context.get("callout_style"),
+            uses_callouts=_detect_callouts(context),
+        )
+
+    def inject_into(self, context: dict[str, Any]) -> None:
+        context["ts_callouts_style"] = self.style
+
+
+class CalloutsFragment(BaseFragment[CalloutsConfig]):
+    name: ClassVar[str] = "ts-callouts"
+    description: ClassVar[str] = "Reusable callout styles shared by built-in templates."
+    pieces: ClassVar[list[FragmentPiece]] = [
+        FragmentPiece(
+            template_path=Path(__file__).with_name("ts-callouts.jinja.sty"),
+            kind="package",
+            slot="extra_packages",
+        )
+    ]
+    attributes: ClassVar[dict[str, TemplateAttributeSpec]] = {
+        "callout_style": TemplateAttributeSpec(
+            default="fancy",
+            type="string",
+            choices=["fancy", "classic", "minimal"],
+            sources=[
+                "callouts.style",
+                "callout_style",
+            ],
+            normaliser="callout_style",
+        )
+    }
+    config_cls: ClassVar[type[CalloutsConfig]] = CalloutsConfig
+    source: ClassVar[Path] = Path(__file__).with_name("ts-callouts.jinja.sty")
+    context_defaults: ClassVar[dict[str, Any]] = {"extra_packages": ""}
+
+    def build_config(
+        self, context: Mapping[str, Any], overrides: Mapping[str, Any] | None = None
+    ) -> CalloutsConfig:
+        _ = overrides
+        return self.config_cls.from_context(context)
+
+    def inject(
+        self,
+        config: CalloutsConfig,
+        context: dict[str, Any],
+        overrides: Mapping[str, Any] | None = None,
+    ) -> None:
+        _ = overrides
+        config.inject_into(context)
+
+    def should_render(self, config: CalloutsConfig) -> bool:
+        return config.uses_callouts
+
+
+def _detect_callouts(context: Mapping[str, Any]) -> bool:
+    uses_flag = context.get("ts_uses_callouts")
+    if isinstance(uses_flag, bool) and uses_flag:
+        return True
+
+    for value in context.values():
+        if not isinstance(value, str):
+            continue
+        if "\\begin{callout" in value:
+            return True
+    return False
+
+
+fragment = CalloutsFragment()
+
+__all__ = ["CalloutsConfig", "CalloutsFragment", "fragment"]

texsmith/fragments/callouts/fragment.toml

@@ -0,0 +1,3 @@
+name = "ts-callouts"
+description = "Reusable callout styles shared by built-in templates."
+entrypoint = "texsmith.fragments.callouts:fragment"

texsmith/fragments/callouts/ts-callouts.jinja.sty

@@ -0,0 +1,129 @@
+\ProvidesPackage{ts-callouts}[2025/11/21 TeXSmith Callouts (generated)]
+
+\RequirePackage{xcolor}
+
+\makeatletter
+\@ifpackageloaded{tcolorbox}{}{%
+  \RequirePackage{tcolorbox}%
+}
+
+\@ifundefined{tcbmany}{%
+  \tcbuselibrary{many}%
+}{}
+
+\@ifundefined{tcbbreakable}{%
+  \tcbuselibrary{breakable}%
+}{}
+
+\@ifundefined{tcbskins}{%
+  \tcbuselibrary{skins}%
+}{}
+
+\makeatother
+
+\newcommand{\texsmithCalloutStyleDefault}{\VAR{callout_style|default('fancy')}}
+\providecommand{\texsmithCalloutStyle}{\texsmithCalloutStyleDefault}
+\providecommand{\texsmithCalloutIcon}[1]{\texsmithEmoji{#1}}
+\providecommand{\texsmithCalloutTitleFormat}[1]{\bfseries ~#1}
+
+\BLOCK{ set style = callout_style | default("fancy") }
+\BLOCK{ set callouts = callouts_definitions | default({}) }
+
+\BLOCK{ for name, cfg in callouts.items() }
+\definecolor{callout\VAR{name|capitalize}Bg}{HTML}{\VAR{cfg.get("background_color", "F0F0F0")}}
+\definecolor{callout\VAR{name|capitalize}Frame}{HTML}{\VAR{cfg.get("border_color", "808080")}}
+\definecolor{callout\VAR{name|capitalize}Title}{HTML}{\VAR{cfg.get("title_color", cfg.get("border_color", "808080"))}}
+\BLOCK{ endfor }
+
+\BLOCK{ if style == "classic" }
+% Classic (monochrome) style
+\tcbset{callout base/.style={
+  breakable,
+  enhanced,
+  title filled=false,
+  arc=0mm,
+  boxrule=0mm,
+  titlerule=0mm,
+  lefttitle=0mm,
+  leftupper=1mm,
+  left=2mm,
+  colback=white,
+  colbacktitle=white,
+  colframe=black!80,
+  coltitle=black!80,
+  parbox=false,
+  frame hidden,
+  borderline west={1mm}{0mm}{black!60},
+}}
+\BLOCK{ for name, cfg in callouts.items() }
+\tcbset{callout \VAR{name}/.style={callout base,title={\makebox[1.6em][c]{\texsmithCalloutIcon{\VAR{cfg.get("icon","ℹ")}}}}}}
+\BLOCK{ endfor }
+\newtcolorbox{callout}[2][]{%
+  callout base,
+  #1,
+  after title={\texsmithCalloutTitleFormat{#2}}%
+}
+\BLOCK{ elif style == "minimal" }
+% Minimal style (borders only, no icons). Prefix title with bold label.
+\renewcommand{\texsmithCalloutTitleFormat}[1]{\noindent\MakeUppercase{#1}:~}
+\tcbset{callout base/.style={
+  breakable,
+  enhanced,
+  title filled=false,
+  arc=0.4mm,
+  boxrule=0.3mm,
+  titlerule=0mm,
+  lefttitle=0.2em,
+  leftupper=1mm,
+  colback=white,
+  colframe=black,
+  colbacktitle=white,
+  coltitle=black,
+  titlerule=0.2mm,
+  parbox=false,
+}}
+\BLOCK{ for name, cfg in callouts.items() }
+\tcbset{callout \VAR{name}/.style={callout base}}
+\BLOCK{ endfor }
+\newtcolorbox{callout}[2][]{%
+  callout base,
+  title={\bfseries #2},
+  #1,
+  after title={}%
+}
+\BLOCK{ else }
+% Fancy style (colored, icons)
+\renewcommand{\texsmithCalloutTitleFormat}[1]{\raisebox{0.2em}{\bfseries ~#1}}
+\tcbset{callout base/.style={
+  breakable,
+  enhanced,
+  arc=0.7mm,
+  boxrule=0.1mm,
+  titlerule=0mm,
+  left=3mm,
+  lefttitle=0.8mm,
+  leftupper=1.5mm,
+  coltitle=black,
+  fonttitle=\bfseries\sffamily,
+  parbox=false,
+}}
+\BLOCK{ for name, cfg in callouts.items() }
+\tcbset{
+  callout \VAR{name}/.style={
+    callout base,
+    colback=white,
+    colframe=callout\VAR{name|capitalize}Frame,
+    colbacktitle=callout\VAR{name|capitalize}Frame!5!white,
+    coltitle=callout\VAR{name|capitalize}Title,
+    borderline west={1.5mm}{0mm}{callout\VAR{name|capitalize}Frame},
+    title={\makebox[1.6em][c]{\raisebox{0.05em}{\scalebox{1.1}{\texsmithCalloutIcon{\VAR{cfg.get("icon","ℹ")}}}}}},
+  }
+}
+\BLOCK{ endfor }
+
+\newtcolorbox{callout}[2][]{%
+  callout base,
+  #1,
+  after title={\texsmithCalloutTitleFormat{#2}}%
+}
+\BLOCK{ endif }

texsmith/fragments/code/__init__.py

@@ -0,0 +1,82 @@
+from __future__ import annotations
+
+from collections.abc import Mapping
+from dataclasses import dataclass
+from pathlib import Path
+from typing import Any, ClassVar
+
+from texsmith.core.fragments.base import BaseFragment, FragmentPiece
+from texsmith.core.templates.manifest import TemplateAttributeSpec
+
+
+@dataclass(frozen=True)
+class CodeConfig:
+    options: dict[str, Any]
+    uses_code: bool
+
+    @classmethod
+    def from_context(cls, context: Mapping[str, Any]) -> CodeConfig:
+        options = context.get("code") or {}
+        return cls(options=dict(options), uses_code=_detect_code(context))
+
+    def inject_into(self, context: dict[str, Any]) -> None:
+        context["ts_code_options"] = self.options
+        context["ts_code_enabled"] = self.uses_code
+
+
+class CodeFragment(BaseFragment[CodeConfig]):
+    name: ClassVar[str] = "ts-code"
+    description: ClassVar[str] = "Configurable code listings used by Markdown code blocks."
+    pieces: ClassVar[list[FragmentPiece]] = [
+        FragmentPiece(
+            template_path=Path(__file__).with_name("ts-code.jinja.sty"),
+            kind="package",
+            slot="extra_packages",
+        )
+    ]
+    attributes: ClassVar[dict[str, TemplateAttributeSpec]] = {
+        "code": TemplateAttributeSpec(
+            default={"engine": "pygments", "style": "bw"},
+            type="mapping",
+            normaliser="code_options",
+            sources=[
+                "code",
+            ],
+        )
+    }
+    config_cls: ClassVar[type[CodeConfig]] = CodeConfig
+    source: ClassVar[Path] = Path(__file__).with_name("ts-code.jinja.sty")
+    context_defaults: ClassVar[dict[str, Any]] = {"extra_packages": ""}
+
+    def build_config(
+        self, context: Mapping[str, Any], overrides: Mapping[str, Any] | None = None
+    ) -> CodeConfig:
+        _ = overrides
+        return self.config_cls.from_context(context)
+
+    def inject(
+        self,
+        config: CodeConfig,
+        context: dict[str, Any],
+        overrides: Mapping[str, Any] | None = None,
+    ) -> None:
+        _ = overrides
+        config.inject_into(context)
+
+    def should_render(self, config: CodeConfig) -> bool:
+        return config.uses_code
+
+
+def _detect_code(context: Mapping[str, Any]) -> bool:
+    for value in context.values():
+        if not isinstance(value, str):
+            continue
+        lowered = value.lower()
+        if "\\begin{code" in lowered or "\\begin{minted" in lowered or "\\py{" in lowered:
+            return True
+    return False
+
+
+fragment = CodeFragment()
+
+__all__ = ["CodeConfig", "CodeFragment", "fragment"]

texsmith/fragments/code/fragment.toml

@@ -0,0 +1,3 @@
+name = "ts-code"
+description = "Minted-based code listings used by Markdown code blocks."
+entrypoint = "texsmith.fragments.code:fragment"

texsmith/fragments/code/ts-code.jinja.sty

@@ -0,0 +1,140 @@
+\BLOCK{ set _code_cfg = code if code is not none else {} }
+\BLOCK{ if _code_cfg is mapping }
+\BLOCK{ set _code_engine = (_code_cfg.get("engine") or "pygments") | lower }
+\BLOCK{ set _code_style = _code_cfg.get("style") or "bw" }
+\BLOCK{ else }
+\BLOCK{ set _code_engine = (_code_cfg or "pygments") | string | lower }
+\BLOCK{ set _code_style = "bw" }
+\BLOCK{ endif }
+
+\ProvidesPackage{ts-code}[2025/11/21 TeXSmith Code listings (generated)]
+
+\RequirePackage{xparse}
+
+\makeatletter
+\@ifpackageloaded{tcolorbox}{}{%
+  \RequirePackage{tcolorbox}%
+}
+\makeatother
+
+\tcbuselibrary{many}
+
+\BLOCK{ if _code_engine == "minted" }
+\makeatletter
+\@ifpackageloaded{minted}{}{%
+  \RequirePackage{minted}%
+}
+\makeatother
+\tcbuselibrary{minted}
+\usemintedstyle{\VAR{_code_style}}
+
+\newtcblisting[auto counter,number within=section,
+  list inside=mypyg]{code}[4][]{%
+  breakable,
+  listing only,
+  enhanced,
+  colback=white,
+  colframe=black!90,
+  colbacktitle=white,
+  coltitle=black,
+  pad at break*=1mm,
+  toptitle=0.15em,
+  bottomtitle=0.1em,
+  boxrule=0.07em,
+  fonttitle=\bfseries,
+  minted language=#2,
+  top=1mm,
+  arc=0.5mm,
+  bottom=1mm,
+  minted options={%
+      tabsize=4,
+      breaklines,
+      xleftmargin=-0.75em,
+      fontsize=\footnotesize,
+      highlightcolor=gray!30,
+      ignorelexererrors,
+      #4
+    },
+  before title={\hspace*{-0.9em}},
+  title={#3},
+  list entry={\protect\numberline{\thetcbcounter}#3},
+  #1
+}
+\BLOCK{ elif _code_engine == "listings" }
+\RequirePackage{xcolor}
+\makeatletter
+\@ifpackageloaded{listings}{}{%
+  \RequirePackage{listings}%
+}
+\makeatother
+\tcbuselibrary{listings,skins}
+
+\lstset{
+  basicstyle=\ttfamily\footnotesize,
+  breaklines=true,
+  columns=fullflexible,
+}
+
+\newtcblisting[auto counter,number within=section,
+  list inside=mypyg]{code}[4][]{%
+  breakable,
+  enhanced,
+  listing only,
+  colback=white,
+  colframe=black!90,
+  colbacktitle=white,
+  coltitle=black,
+  pad at break*=1mm,
+  toptitle=0.15em,
+  bottomtitle=0.1em,
+  boxrule=0.07em,
+  fonttitle=\bfseries,
+  top=1mm,
+  left=1mm,
+  arc=0.5mm,
+  bottom=1mm,
+  title={#3},
+  list entry={\protect\numberline{\thetcbcounter}#3},
+  listing options={language=#2, breaklines=true, columns=fullflexible #4},
+  #1
+}
+\BLOCK{ else }
+\RequirePackage{fancyvrb}
+\RequirePackage{fvextra}
+\BLOCK{ if _code_engine == "pygments" }
+\RequirePackage{color}
+\BLOCK{ endif }
+
+\newtcolorbox[auto counter,number within=section,
+  list inside=mypyg]{code}[4][]{%
+  breakable,
+  enhanced,
+  colback=white,
+  colframe=black!90,
+  colbacktitle=white,
+  coltitle=black,
+  pad at break*=1mm,
+  toptitle=0.15em,
+  bottomtitle=0.1em,
+  boxrule=0.07em,
+  fonttitle=\bfseries,
+  top=1mm,
+  left=1mm,
+  arc=0.5mm,
+  bottom=1mm,
+  title={#3},
+  list entry={\protect\numberline{\thetcbcounter}#3},
+  #1
+}
+
+\RecustomVerbatimEnvironment{Verbatim}{Verbatim}{
+    breaklines,
+    breakanywhere,
+    commandchars=\\\{\},
+    highlightcolor=gray!20,
+}
+
+\BLOCK{ if _code_engine == "pygments" }
+\VAR{pygments_style_defs|default('')}
+\BLOCK{ endif }
+\BLOCK{ endif }