forktex-documents 0.1.0__py3-none-any.whl

forktex_documents/__init__.py

@@ -0,0 +1,291 @@
+# Copyright (C) 2026 FORKTEX S.R.L.
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later OR LicenseRef-ForkTex-Commercial
+#
+# This file is part of ForkTex Documents.
+#
+# For commercial licensing -- including use in proprietary products, SaaS
+# deployments, or any context where AGPL obligations cannot be met -- you
+# MUST obtain a commercial license from FORKTEX S.R.L. (info@forktex.com).
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Affero General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU Affero General Public License for more details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+"""forktex-documents — every document the company issues, from one framework.
+
+A contract, an invoice, an offer, a report, a deck: all the same thing. Structured data,
+composed into a canonical, projected through a theme. Particular kinds are instantiations
+over the common denominator, never parallel frameworks.
+
+The shape, in one pass:
+
+```python
+DocumentRequest        what you author: entity refs + params            (JSON, the truth)
+    ↓ resolve + localize + compose            ← all arithmetic lives here
+FamilyCanonical        what the document means; mandates checked
+    ↓ .blocks()                               ↓ read directly
+Document (block tree)                         UBL / e-Factura XML
+    ↓ project(theme)
+Artifact               html · pdf                (a UI over the JSON)
+```
+
+`__all__` is the contract. Anything not in it is internal and may move.
+"""
+
+from __future__ import annotations
+
+from forktex_documents.domain.base import DocumentModel
+from forktex_documents.domain.blocks import (
+    Block,
+    CalloutBlock,
+    CardBlock,
+    ChartBlock,
+    ChecklistBlock,
+    ChecklistOption,
+    ClauseBlock,
+    Column,
+    ComparisonBlock,
+    ComparisonRow,
+    DataPoint,
+    FeatureItem,
+    FeatureListBlock,
+    FlowBlock,
+    FlowStep,
+    FootRow,
+    GroupedTableBlock,
+    HeadingBlock,
+    HeatmapBlock,
+    ImageBlock,
+    ImageGridBlock,
+    KeyValue,
+    KeyValuesBlock,
+    ListBlock,
+    ListItem,
+    MatrixBlock,
+    MoneyLine,
+    PageBreakBlock,
+    ParagraphBlock,
+    PartyCardBlock,
+    Series,
+    Signatory,
+    SignaturesBlock,
+    SpacerBlock,
+    StatTile,
+    StatTilesBlock,
+    TableBlock,
+    TableGroup,
+    TimelineBlock,
+    TimelineEntry,
+    TotalsBlock,
+)
+from forktex_documents.domain.canonical import FamilyCanonical, Mandate, check_mandates
+from forktex_documents.domain.catalog import (
+    Catalog,
+    DocTypeDefinition,
+    FamilyDefinition,
+    InputSpec,
+    check_fragment_paths,
+    resolve_inheritance,
+)
+from forktex_documents.domain.document import Band, Document, Section
+from forktex_documents.domain.entities import (
+    BankAccount,
+    EntityKindSpec,
+    EntityRef,
+    FieldSpec,
+    Party,
+    PostalAddress,
+    Product,
+    ResolvedEntity,
+    compile_entity_model,
+)
+from forktex_documents.domain.errors import (
+    AssetMissingError,
+    CatalogError,
+    ComposeError,
+    EntityResolutionError,
+    InheritanceError,
+    LocalizationError,
+    NumberingError,
+    PlaceholderError,
+    ProjectionError,
+    SchemaViolationError,
+    UnknownDocTypeError,
+)
+from forktex_documents.domain.fiscal import (
+    RetentionPolicy,
+    VatRate,
+    VatSchedule,
+    markup_from_price,
+    price_from_markup,
+)
+from forktex_documents.domain.formatting import RenderContext
+from forktex_documents.domain.instance import DocumentInstance, DocumentRequest, SourceVersions
+from forktex_documents.domain.localization import (
+    LegislationProfile,
+    LocaleBundle,
+    Localization,
+    TextFragment,
+)
+from forktex_documents.domain.numbering import DocumentNumber, SeriesKey
+from forktex_documents.domain.registry import (
+    build,
+    canonicals_by_family,
+    dump,
+    known,
+    registered,
+    verify_registry,
+)
+from forktex_documents.domain.series import BURNED, InMemoryRegister
+from forktex_documents.domain.theme import (
+    ChartPalette,
+    InkTokens,
+    PageGeometry,
+    Theme,
+    TypeScale,
+)
+from forktex_documents.ports import (
+    Artifact,
+    ArtifactStore,
+    AssetSource,
+    ComposeContext,
+    Composer,
+    DocTypeSource,
+    EntityResolver,
+    LocaleSource,
+    Numberer,
+    Projector,
+)
+from forktex_documents.render.assets import LayeredAssets, PackagedAssets
+from forktex_documents.render.charts import render_chart, render_heatmap
+from forktex_documents.render.projector import HtmlProjector
+
+__all__ = [
+    "BURNED",
+    "Artifact",
+    "ArtifactStore",
+    "AssetMissingError",
+    "AssetSource",
+    "Band",
+    "BankAccount",
+    "Block",
+    "CalloutBlock",
+    "CardBlock",
+    "Catalog",
+    "CatalogError",
+    "ChartBlock",
+    "ChartPalette",
+    "ChecklistBlock",
+    "ChecklistOption",
+    "ClauseBlock",
+    "Column",
+    "ComparisonBlock",
+    "ComparisonRow",
+    "ComposeContext",
+    "ComposeError",
+    "Composer",
+    "DataPoint",
+    "DocTypeDefinition",
+    "DocTypeSource",
+    "Document",
+    "DocumentInstance",
+    "DocumentModel",
+    "DocumentNumber",
+    "DocumentRequest",
+    "EntityKindSpec",
+    "EntityRef",
+    "EntityResolutionError",
+    "EntityResolver",
+    "FamilyCanonical",
+    "FamilyDefinition",
+    "FeatureItem",
+    "FeatureListBlock",
+    "FieldSpec",
+    "FlowBlock",
+    "FlowStep",
+    "FootRow",
+    "GroupedTableBlock",
+    "HeadingBlock",
+    "HeatmapBlock",
+    "HtmlProjector",
+    "ImageBlock",
+    "ImageGridBlock",
+    "InMemoryRegister",
+    "InheritanceError",
+    "InkTokens",
+    "InputSpec",
+    "KeyValue",
+    "KeyValuesBlock",
+    "LayeredAssets",
+    "LegislationProfile",
+    "ListBlock",
+    "ListItem",
+    "LocaleBundle",
+    "LocaleSource",
+    "Localization",
+    "LocalizationError",
+    "Mandate",
+    "MatrixBlock",
+    "MoneyLine",
+    "Numberer",
+    "NumberingError",
+    "PackagedAssets",
+    "PageBreakBlock",
+    "PageGeometry",
+    "ParagraphBlock",
+    "Party",
+    "PartyCardBlock",
+    "PlaceholderError",
+    "PostalAddress",
+    "Product",
+    "ProjectionError",
+    "Projector",
+    "RenderContext",
+    "ResolvedEntity",
+    "RetentionPolicy",
+    "SchemaViolationError",
+    "Section",
+    "Series",
+    "SeriesKey",
+    "Signatory",
+    "SignaturesBlock",
+    "SourceVersions",
+    "SpacerBlock",
+    "StatTile",
+    "StatTilesBlock",
+    "TableBlock",
+    "TableGroup",
+    "TextFragment",
+    "Theme",
+    "TimelineBlock",
+    "TimelineEntry",
+    "TotalsBlock",
+    "TypeScale",
+    "UnknownDocTypeError",
+    "VatRate",
+    "VatSchedule",
+    "build",
+    "canonicals_by_family",
+    "check_fragment_paths",
+    "check_mandates",
+    "compile_entity_model",
+    "dump",
+    "known",
+    "markup_from_price",
+    "price_from_markup",
+    "registered",
+    "render_chart",
+    "render_heatmap",
+    "resolve_inheritance",
+    "verify_registry",
+]

forktex_documents/assets/styles/paged.css

@@ -0,0 +1,314 @@
+/*
+ * Copyright (C) 2026 FORKTEX S.R.L.
+ *
+ * SPDX-License-Identifier: AGPL-3.0-or-later OR LicenseRef-ForkTex-Commercial
+ *
+ * This file is part of ForkTex Documents.
+ *
+ * For commercial licensing -- including use in proprietary products, SaaS
+ * deployments, or any context where AGPL obligations cannot be met -- you
+ * MUST obtain a commercial license from FORKTEX S.R.L. (info@forktex.com).
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see <https://www.gnu.org/licenses/>.
+ */
+
+/* ==========================================================================
+   paged.css — page structure and the block vocabulary.
+
+   Every colour, size and measurement is a CSS custom property emitted from the
+   Theme. Nothing here carries a literal brand colour, which is what makes
+   re-theming a document a change to one object rather than to this file.
+
+   The pagination half is carried from the one renderer that got it right; the
+   comments say why each rule exists, because each of them is load-bearing and
+   none is obvious.
+   ========================================================================== */
+
+@page {
+  size: var(--page-width) var(--page-height);
+  margin: var(--margin-top) var(--margin-right) var(--margin-bottom) var(--margin-left);
+
+  /* The current section's name, lifted by `string-set` below. This is how a
+     reader of page 7 knows which section they are in. */
+  @top-left  { content: string(band-left);  font-size: var(--size-micro); color: var(--ink-muted);
+               vertical-align: bottom; padding-bottom: 4mm; }
+  @top-right { content: string(band-right); font-size: var(--size-micro); color: var(--ink-muted);
+               vertical-align: bottom; padding-bottom: 4mm; }
+  @bottom-left  { content: string(foot-left); font-size: var(--size-micro); color: var(--ink-muted);
+                  vertical-align: top; padding-top: 4mm; }
+  /* counter(pages) is why a total page count is possible at all — it is resolved
+     after layout, so nothing upstream can know it. */
+  @bottom-right { content: counter(page) " / " counter(pages);
+                  font-size: var(--size-micro); color: var(--ink-muted);
+                  vertical-align: top; padding-top: 4mm; }
+}
+
+/* A cover page takes the full sheet: no margins, no bands, no number. */
+@page cover { margin: 0; @top-left{content:none} @top-right{content:none}
+              @bottom-left{content:none} @bottom-right{content:none} }
+.cover { page: cover; break-after: page; }
+
+/* ---- page-break control -------------------------------------------------
+   `keep` is emitted by the projector for every block whose kind declares
+   itself atomic. A signature block split across a page boundary produces a
+   document where one party signs a page that does not name the other. */
+.keep            { break-inside: avoid; }
+.break-before    { break-before: page; }
+h1, h2, h3, h4   { break-after: avoid; }   /* never orphan a heading */
+h2 + *, h3 + *   { break-before: avoid; }
+p                { orphans: 3; widows: 3; }
+tr               { break-inside: avoid; }
+thead            { display: table-header-group; }  /* repeat on every page */
+tfoot            { display: table-footer-group; }  /* total stays with its table */
+
+/* ---- base --------------------------------------------------------------- */
+html { font-size: var(--size-body); }
+body {
+  font-family: var(--font-sans);
+  font-size: var(--size-body);
+  line-height: var(--line-height);
+  color: var(--ink-primary);
+  background: var(--surface);
+  margin: 0;
+}
+p { margin: 0 0 2.2mm; }
+strong { font-weight: 600; }
+code { font-family: var(--font-mono); font-size: 0.92em; }
+a { color: inherit; text-decoration: none; }
+
+/* A filled-in value, as opposed to boilerplate. The internship contract marks
+   every supplied date and amount this way; it is how a reader checks a draft. */
+.value { color: var(--accent-ink); font-weight: 600; }
+
+/* ---- document furniture ------------------------------------------------- */
+.doc-head { display: flex; justify-content: space-between; align-items: flex-start;
+            border-bottom: 0.6mm solid var(--accent-ink); padding-bottom: 3mm; margin-bottom: 8mm; }
+.doc-head .issuer   { font-weight: 700; letter-spacing: 0.01em; }
+.doc-head .idline   { font-size: var(--size-micro); color: var(--ink-secondary); margin-top: 0.8mm; }
+.doc-head .ref      { text-align: right; font-weight: 700; font-size: var(--size-small); }
+.doc-head .ref .date{ font-weight: 400; color: var(--ink-secondary); margin-top: 0.8mm; }
+
+.doc-title  { font-size: var(--size-h1); font-weight: 700; line-height: 1.15; margin: 0 0 1.5mm; }
+.doc-title.centered { text-align: center; color: var(--accent-ink); }
+.doc-sub    { color: var(--ink-secondary); margin: 0 0 2mm; }
+.doc-meta   { font-size: var(--size-small); color: var(--ink-muted); margin: 0 0 7mm; }
+.title-rule { width: 14mm; height: 0.9mm; background: var(--accent-ink); margin: 2.5mm auto 6mm; }
+
+/* ---- headings ----------------------------------------------------------- */
+h2, h3, h4 { margin: 7mm 0 2.5mm; font-weight: 700; }
+h2 { font-size: var(--size-h2); }
+h3 { font-size: var(--size-h3); }
+h4 { font-size: var(--size-body); }
+.h-rule   { border-bottom: 0.35mm solid var(--accent-ink); padding-bottom: 1.6mm; }
+.h-band   { background: var(--accent-ink); color: #fff; padding: 1.8mm 3mm; margin: 7mm 0 0;
+            font-size: var(--size-h3); }
+.h-eyebrow{ display: block; background: var(--surface-soft); color: var(--accent-ink);
+            border-radius: 4mm; padding: 1.4mm 4mm; font-size: var(--size-micro);
+            font-weight: 700; letter-spacing: 0.12em; text-transform: uppercase; margin: 0 0 3mm; }
+.h-num { color: var(--ink-muted); font-variant-numeric: tabular-nums; }
+
+/* ---- lists -------------------------------------------------------------- */
+ul, ol { margin: 0 0 2.5mm; padding-left: 5mm; }
+li { margin-bottom: 0.9mm; }
+li > ul, li > ol { margin-top: 0.9mm; }
+
+/* ---- clauses ------------------------------------------------------------ */
+.clause { margin: 5mm 0; }
+.clause-head { display: flex; align-items: baseline; gap: 2.5mm; margin-bottom: 1.8mm; }
+.clause-badge { display: inline-block; min-width: 5.5mm; text-align: center;
+                background: var(--accent-ink); color: #fff; font-weight: 700;
+                font-size: var(--size-small); border-radius: 1.2mm; padding: 0.6mm 1.2mm; }
+.clause-title { font-weight: 700; }
+.clause-body { margin-left: 0; }
+.clause .clause { margin-left: 6mm; }   /* nesting reads as indentation */
+
+/* ---- party card --------------------------------------------------------- */
+.party-card { border: 0.25mm solid var(--border); background: var(--surface-soft);
+              border-radius: 2mm; padding: 4mm 5mm; margin: 3mm 0; }
+.party-role { font-size: var(--size-micro); text-transform: uppercase; letter-spacing: 0.08em;
+              color: var(--ink-muted); margin-bottom: 1.2mm; }
+.designation { display: inline-block; margin-top: 2.5mm; background: var(--surface-soft);
+               color: var(--accent-ink); border: 0.25mm solid var(--accent-ink);
+               border-radius: 3mm; padding: 1mm 3mm; font-size: var(--size-micro);
+               font-weight: 700; letter-spacing: 0.06em; text-transform: uppercase; }
+.conjunction { text-align: center; color: var(--ink-muted); font-weight: 700;
+               letter-spacing: 0.15em; margin: 2mm 0; font-size: var(--size-small); }
+
+/* ---- tables ------------------------------------------------------------- */
+table { width: 100%; border-collapse: collapse; margin: 3mm 0 4mm; font-size: var(--size-small); }
+th, td { padding: 1.7mm 2.4mm; text-align: left; vertical-align: top;
+         border-bottom: 0.2mm solid var(--border); }
+thead th { background: var(--surface-soft); font-weight: 700; font-size: var(--size-micro);
+           text-transform: uppercase; letter-spacing: 0.05em; color: var(--ink-secondary); }
+table.filled thead th { background: var(--accent-ink); color: #fff; text-transform: none;
+                        letter-spacing: 0; font-size: var(--size-small); }
+td.numeric, th.numeric { text-align: right; font-variant-numeric: tabular-nums; }
+tfoot td { font-weight: 700; background: var(--surface-soft); border-top: 0.4mm solid var(--border); }
+caption { caption-side: top; text-align: left; font-size: var(--size-small);
+          color: var(--ink-secondary); margin-bottom: 1.5mm; }
+.empty { color: var(--ink-muted); }
+ul.cell-list { margin: 0; padding-left: 3.5mm; }
+ul.cell-list li { margin-bottom: 0.5mm; }
+
+/* A grouped table's band header. The columns are shared across groups, so the
+   band is a full-width row inside the same table — separate tables would each
+   size their own columns and the document would visibly wobble. */
+tr.group-band td { background: var(--accent-ink); color: #fff; font-weight: 700;
+                   font-size: var(--size-small); padding: 1.8mm 2.4mm; }
+tr.subtotal td { font-weight: 700; background: var(--surface-soft); }
+
+/* ---- key/value ---------------------------------------------------------- */
+.kv { margin: 3mm 0 4mm; }
+.kv-title { font-weight: 700; margin-bottom: 1.8mm; }
+.kv-grid { display: grid; gap: 1.4mm 5mm; }
+.kv-row { display: flex; gap: 2.5mm; }
+.kv-label { color: var(--ink-secondary); min-width: 32mm; }
+.kv-value { font-weight: 600; }
+
+/* ---- totals ------------------------------------------------------------- */
+.totals { margin: 4mm 0; border: 0.25mm solid var(--border); border-radius: 2mm; overflow: hidden; }
+.totals .line { display: flex; justify-content: space-between; padding: 1.8mm 4mm;
+                border-bottom: 0.2mm solid var(--border); }
+.totals .grand { display: flex; justify-content: space-between; padding: 2.4mm 4mm;
+                 background: var(--surface-soft); font-weight: 700; font-size: var(--size-h3); }
+.totals .amount { font-variant-numeric: tabular-nums; }
+.totals .note { color: var(--ink-muted); font-size: var(--size-micro); }
+
+/* ---- stat tiles --------------------------------------------------------- */
+.tiles { display: flex; flex-wrap: wrap; gap: 3mm; margin: 3mm 0 5mm; }
+.tile { flex: 1 1 34mm; border: 0.25mm solid var(--border); border-radius: 2mm;
+        padding: 3.5mm 4mm; background: var(--surface-soft); }
+.tile .figure { font-size: var(--size-h2); font-weight: 700; color: var(--accent-ink);
+                line-height: 1.1; font-variant-numeric: tabular-nums; }
+.tile .label { font-size: var(--size-micro); text-transform: uppercase; letter-spacing: 0.06em;
+               color: var(--ink-secondary); margin-top: 1mm; }
+.tile .note { font-size: var(--size-micro); color: var(--ink-muted); margin-top: 0.8mm; }
+.tile.good     .figure { color: var(--status-good); }
+.tile.warning  .figure { color: var(--status-warning); }
+.tile.serious  .figure { color: var(--status-serious); }
+.tile.critical .figure { color: var(--status-critical); }
+
+/* ---- cards, callouts ---------------------------------------------------- */
+.card { border: 0.25mm solid var(--border); border-radius: 2.5mm; padding: 4.5mm 5mm;
+        margin: 4mm 0; }
+.card > .card-title { font-weight: 700; font-size: var(--size-h3); margin: 0 0 0.8mm; }
+.card > .card-sub { color: var(--ink-muted); font-size: var(--size-small); margin: 0 0 3mm; }
+/* Form checkboxes. A real bordered box, because the printed form is what gets signed
+   and the signer has to see there is a choice to make. Sized in mm and not em: it is
+   drawn to be written in with a pen. */
+.checklist { margin: 3.5mm 0 4mm; }
+.checklist .option { display: flex; align-items: baseline; gap: 2.5mm; margin-bottom: 1.8mm; }
+.checklist .box { flex: 0 0 auto; width: 4mm; height: 4mm; border: 0.35mm solid var(--ink-primary);
+                  text-align: center; line-height: 3.6mm; font-weight: 700; font-size: 3mm; }
+.checklist .box.unchecked { color: transparent; }
+.checklist .fill { display: inline-block; min-width: 45mm;
+                   border-bottom: 0.25mm dotted var(--ink-secondary); }
+/* The footnote is not an option. Separated from the group so it cannot be read as one. */
+.checklist .form-note { margin-top: 2.5mm; font-size: 8pt; color: var(--ink-secondary); }
+
+.callout { border-left: 0.8mm solid var(--accent-ink); background: var(--surface-soft);
+           padding: 3mm 4mm; margin: 3.5mm 0; border-radius: 0 1.5mm 1.5mm 0; }
+.callout.warning { border-left-color: var(--status-warning); }
+.callout.legal   { border-left-color: var(--status-serious); }
+.callout .callout-title { font-weight: 700; margin-bottom: 1mm; }
+
+/* ---- images ------------------------------------------------------------- */
+figure { margin: 0 0 3mm; }
+figure img { width: 100%; height: auto; display: block; border-radius: 1.5mm;
+             border: 0.2mm solid var(--border); }
+figcaption { font-size: var(--size-micro); color: var(--ink-muted); text-align: center;
+             margin-top: 1.2mm; }
+.image-grid { display: grid; gap: 3mm; margin: 3mm 0 4mm; }
+
+/* ---- feature list, comparison ------------------------------------------- */
+.features { display: flex; flex-direction: column; gap: 2mm; margin: 3mm 0; }
+.feature { display: flex; gap: 3mm; align-items: flex-start; border: 0.25mm solid var(--border);
+           border-radius: 2mm; padding: 2.8mm 3.5mm; }
+.feature .icon { font-size: var(--size-h3); line-height: 1; }
+.feature .f-title { font-weight: 700; }
+.feature .f-detail { color: var(--ink-secondary); font-size: var(--size-small); }
+
+.comparison { display: flex; flex-direction: column; gap: 2mm; margin: 3mm 0; }
+.compare-row { display: grid; grid-template-columns: 1fr 6mm 1fr; align-items: center; gap: 2mm;
+               border: 0.25mm solid var(--border); border-radius: 2mm; padding: 2.4mm 3mm; }
+.compare-row .before { border-left: 0.7mm solid var(--status-critical); padding-left: 2.5mm; }
+.compare-row .after  { border-left: 0.7mm solid var(--status-good);    padding-left: 2.5mm; }
+.compare-row .arrow  { text-align: center; color: var(--ink-muted); }
+.compare-labels { display: grid; grid-template-columns: 1fr 6mm 1fr; gap: 2mm;
+                  font-size: var(--size-micro); text-transform: uppercase;
+                  letter-spacing: 0.08em; color: var(--ink-muted); padding: 0 3mm; }
+
+/* ---- timeline, flow, matrix --------------------------------------------- */
+.timeline { margin: 3mm 0; border-left: 0.35mm solid var(--border); padding-left: 4mm; }
+.timeline .entry { margin-bottom: 2.5mm; }
+.timeline .when { font-weight: 700; font-size: var(--size-small); color: var(--accent-ink); }
+.timeline .detail { color: var(--ink-secondary); font-size: var(--size-small); }
+.flow { display: flex; align-items: stretch; gap: 0; margin: 4mm 0; }
+.flow .step { flex: 1; border: 0.25mm solid var(--border); border-radius: 2mm;
+              padding: 2.8mm 3mm; text-align: center; }
+.flow .step .s-label { font-weight: 700; font-size: var(--size-small); }
+.flow .step .s-detail { color: var(--ink-secondary); font-size: var(--size-micro); }
+.flow .sep { display: flex; align-items: center; color: var(--ink-muted); padding: 0 1.5mm; }
+
+/* ---- charts ------------------------------------------------------------- */
+.chart { margin: 3mm 0 4mm; }
+.chart .chart-title { font-weight: 700; margin-bottom: 1.5mm; }
+.chart svg { display: block; width: 100%; height: auto; }
+.legend { display: flex; flex-wrap: wrap; gap: 4mm; margin-bottom: 2mm;
+          font-size: var(--size-micro); color: var(--ink-secondary); }
+.legend .item { display: flex; align-items: center; gap: 1.5mm; }
+.legend .swatch { width: 2.6mm; height: 2.6mm; border-radius: 0.5mm; }
+.chart-table { font-size: var(--size-micro); }
+
+/* ---- heatmap ------------------------------------------------------------ */
+.heatmap { margin: 3mm 0 4mm; }
+.heatmap svg { display: block; }
+.heatmap .hm-legend { font-size: var(--size-micro); color: var(--ink-muted); margin-top: 1.5mm; }
+
+/* ---- signatures --------------------------------------------------------- */
+.signatures { margin-top: 9mm; }
+.signatures h3 { margin-bottom: 3mm; }
+.sig-row { display: flex; gap: 8mm; }
+.sig { flex: 1; }
+.sig .role   { font-size: var(--size-micro); text-transform: uppercase; letter-spacing: 0.07em;
+               color: var(--ink-muted); }
+.sig .entity { font-weight: 700; margin-top: 0.8mm; }
+.sig .person { color: var(--ink-secondary); font-size: var(--size-small); }
+.sig .line   { border-bottom: 0.25mm solid var(--ink-muted); height: 11mm; margin-top: 1.5mm; }
+.sig .hint   { font-size: var(--size-micro); color: var(--ink-muted); margin-top: 1mm; }
+
+/* ---- slide geometry ----------------------------------------------------- */
+/* A deck is this stylesheet plus a landscape page and one section per slide.
+   Nothing else about a presentation is special. */
+.slide { display: flex; flex-direction: column; min-height: 100%; }
+.slide .slide-title { font-size: var(--size-h1); font-weight: 700; margin: 0 0 2mm; }
+.slide .slide-lede  { font-size: var(--size-h3); color: var(--ink-secondary); margin: 0 0 5mm; }
+
+/* ---- browser preview ---------------------------------------------------- */
+/* The browser shows neither page breaks nor bands, so the PDF is the artefact
+   to check before sending. The sheet outline exists to make the margins real. */
+@media screen {
+  body { background: #E2E8F0; padding: 10mm 0; }
+  .sheet { width: var(--page-width); box-sizing: border-box;
+           padding: var(--margin-top) var(--margin-right) var(--margin-bottom) var(--margin-left);
+           margin: 0 auto 8mm; background: var(--surface);
+           box-shadow: 0 2px 14px rgba(2,8,23,0.18); }
+}
+@media print { .sheet { width: auto; padding: 0; margin: 0; } }
+
+/* The running section name. `string-set` only fires for elements in the box tree,
+   so this is rendered-but-invisible rather than `display:none` — which would set
+   nothing. Zero height with hidden overflow keeps it out of the visible flow. */
+.running-src { string-set: band-right content(); display: block; height: 0;
+               overflow: hidden; font-size: 0; }

forktex_documents/domain/__init__.py

@@ -0,0 +1,36 @@
+# Copyright (C) 2026 FORKTEX S.R.L.
+#
+# SPDX-License-Identifier: AGPL-3.0-or-later OR LicenseRef-ForkTex-Commercial
+#
+# This file is part of ForkTex Documents.
+#
+# For commercial licensing -- including use in proprietary products, SaaS
+# deployments, or any context where AGPL obligations cannot be met -- you
+# MUST obtain a commercial license from FORKTEX S.R.L. (info@forktex.com).
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Affero General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+# GNU Affero General Public License for more details.
+#
+# You should have received a copy of the GNU Affero General Public License
+# along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+"""The domain layer — the document model, and nothing that performs I/O.
+
+Grepping this directory for ``Path``, ``open(`` or ``read_text`` returns nothing but
+docstrings. That is the whole point of the boundary: it makes "the core is pure" a check
+rather than a claim, so a document can be composed and asserted with no filesystem, no
+database and no PDF engine.
+
+Assets, styles and templates reach the renderer through the ``AssetSource`` port instead.
+
+Nothing here is re-exported: consumers import from the package facade, and the layers above
+import the module they need. A layer that re-exports its own contents becomes a second place
+to look for one name.
+"""