docx4j 0.1.0__tar.gz

docx4j-0.1.0/.gitignore

@@ -0,0 +1,15 @@
+# virtual environments
+.venv/
+.venv-fork/
+# python
+__pycache__/
+*.pyc
+.pytest_cache/
+*.egg-info/
+# generated at run time
+out/
+.claude/
+# the unmodified-xsdata output of the first experiment; reproducible from .xsdata.xml with upstream xsdata 26.2
+baseline/
+# the build (python -m build, scripts/release_check.sh)
+dist/

docx4j-0.1.0/.xsdata.phase-b.xml

@@ -0,0 +1,164 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  CR-001 Phase B generator configuration: WML as one module per namespace, under
+  short docx4j-style package names, every class a docx4j_py.child.Child, every
+  list a docx4j_py.child.ChildList.
+
+      .venv-fork/bin/docx4j-xsdata generate -c .xsdata.phase-b.xml schemas/wml/wml.xsd
+
+  See codegen/README.md. The old .xsdata.xml is kept as-is: it is the clusters
+  layout that produced the unmodified-xsdata baseline in baseline/docx4j_py/generated.
+-->
+<Config xmlns="http://pypi.org/project/xsdata" version="26.2">
+  <Output maxLineLength="99" genericCollections="false">
+    <Package>docx4j_py</Package>
+    <Format repr="true" eq="true" order="false" unsafeHash="false" frozen="false" slots="true">dataclasses</Format>
+    <Structure>namespaces</Structure>
+    <DocstringStyle>Blank</DocstringStyle>
+    <RelativeImports>false</RelativeImports>
+    <CompoundFields defaultName="content" useSubstitutionGroups="true" forceDefaultName="false" maxNameParts="3">true</CompoundFields>
+    <WrapperFields>false</WrapperFields>
+    <UnnestClasses>true</UnnestClasses>
+    <IgnorePatterns>false</IgnorePatterns>
+    <IncludeHeader>false</IncludeHeader>
+    <AllOptional>true</AllOptional>
+    <SchemaDefaults>metadata</SchemaDefaults>
+    <ListFactory>docx4j_py.child.ChildList</ListFactory>
+    <DeferredImports>true</DeferredImports>
+    <ClassNames>codegen/names</ClassNames>
+  </Output>
+  <Conventions>
+    <ClassName case="pascalCase" safePrefix="type"/>
+    <FieldName case="snakeCase" safePrefix="value"/>
+    <ConstantName case="screamingSnakeCase" safePrefix="value"/>
+    <ModuleName case="snakeCase" safePrefix="mod"/>
+    <PackageName case="snakeCase" safePrefix="pkg"/>
+  </Conventions>
+  <Substitutions>
+    <!--
+      One entry per namespace in WML's import closure. The search must fullmatch
+      the namespace URI; the replacement is a dotted path appended to <Package>,
+      whose LAST segment becomes the module name and the rest the package. So
+      "dml.main" is docx4j_py/dml/main.py and "wml" is docx4j_py/wml.py.
+
+      Names follow org.docx4j.* where that reads well in Python (wml, dml, math,
+      mce, relationships, w14, w15), and the ECMA/docx4j prefix where the Java
+      package is the machine-generated com.microsoft.schemas.* form (wps, wpg,
+      wpc, wne, cx, a14, ...). The Microsoft drawing extension namespaces are
+      collected under docx4j_py.oart, as docx4j collects their schemas in
+      xsd/odrawxml.
+
+      This table also disposes of the namespaces-layout shadowing bug (fork
+      CHANGES.md, upstream report 4): .../2018/animation is a prefix of
+      .../2018/animation/model3d, which without a substitution produces
+      oart/animation.py next to oart/animation/, and the package hides the
+      module. They are named animation_2018 and animation_model3d_2018 here, so
+      no module and package can collide and no module-name substitution is
+      needed.
+    -->
+    <Substitution type="package" search="http://www.w3.org/2001/XMLSchema" replace="xs"/>
+    <Substitution type="package" search="http://www.w3.org/2001/XMLSchema-instance" replace="xsi"/>
+    <Substitution type="package" search="http://www.w3.org/XML/1998/namespace" replace="xml_ns"/>
+    <Substitution type="package" search="http://www.w3.org/1998/Math/MathML" replace="mathml"/>
+    <Substitution type="package" search="http://www.w3.org/2003/InkML" replace="inkml"/>
+
+    <!-- ECMA-376 -->
+    <Substitution type="package" search="http://schemas.openxmlformats.org/wordprocessingml/2006/main" replace="wml"/>
+    <Substitution type="package" search="http://schemas.openxmlformats.org/officeDocument/2006/math" replace="math"/>
+    <Substitution type="package" search="http://schemas.openxmlformats.org/officeDocument/2006/relationships" replace="relationships_r"/>
+
+    <!--
+      CR-002 section 9: the package relationships part and the three docProps
+      parts. docx4j calls them org.docx4j.relationships, org.docx4j.docProps.core
+      (with .core.dc.elements, .core.dc.terms), .extended, .custom and
+      .variantTypes; the Dublin Core packages are flattened one level here
+      because in Python `docprops.core` cannot be both a module and a package.
+    -->
+    <Substitution type="package" search="http://schemas.openxmlformats.org/package/2006/relationships" replace="relationships"/>
+    <Substitution type="package" search="http://schemas.openxmlformats.org/package/2006/metadata/core-properties" replace="docprops.core"/>
+    <Substitution type="package" search="http://schemas.openxmlformats.org/officeDocument/2006/extended-properties" replace="docprops.extended"/>
+    <Substitution type="package" search="http://schemas.openxmlformats.org/officeDocument/2006/custom-properties" replace="docprops.custom"/>
+    <Substitution type="package" search="http://schemas.openxmlformats.org/officeDocument/2006/docPropsVTypes" replace="docprops.variant_types"/>
+    <Substitution type="package" search="http://purl.org/dc/elements/1.1/" replace="docprops.dc"/>
+    <Substitution type="package" search="http://purl.org/dc/terms/" replace="docprops.dcterms"/>
+    <Substitution type="package" search="http://purl.org/dc/dcmitype/" replace="docprops.dcmitype"/>
+    <Substitution type="package" search="http://schemas.openxmlformats.org/officeDocument/2006/sharedTypes" replace="shared_types"/>
+    <Substitution type="package" search="http://schemas.openxmlformats.org/markup-compatibility/2006" replace="mce"/>
+    <Substitution type="package" search="http://schemas.openxmlformats.org/schemaLibrary/2006/main" replace="customxml"/>
+    <Substitution type="package" search="http://schemas.openxmlformats.org/drawingml/2006/main" replace="dml.main"/>
+    <Substitution type="package" search="http://schemas.openxmlformats.org/drawingml/2006/picture" replace="dml.picture"/>
+    <Substitution type="package" search="http://schemas.openxmlformats.org/drawingml/2006/wordprocessingDrawing" replace="dml.wordprocessing_drawing"/>
+    <Substitution type="package" search="http://schemas.openxmlformats.org/drawingml/2006/chart" replace="dml.chart"/>
+    <Substitution type="package" search="http://schemas.openxmlformats.org/drawingml/2006/chartDrawing" replace="dml.chart_drawing"/>
+    <Substitution type="package" search="http://schemas.openxmlformats.org/drawingml/2006/diagram" replace="dml.diagram"/>
+    <Substitution type="package" search="http://schemas.openxmlformats.org/drawingml/2006/lockedCanvas" replace="dml.locked_canvas"/>
+    <Substitution type="package" search="http://schemas.openxmlformats.org/drawingml/2006/spreadsheetDrawing" replace="dml.spreadsheet_drawing"/>
+    <Substitution type="package" search="http://schemas.openxmlformats.org/drawingml/2006/compatibility" replace="dml.compatibility"/>
+
+    <!-- Microsoft word extensions -->
+    <Substitution type="package" search="http://schemas.microsoft.com/office/word/2006/wordml" replace="wne"/>
+    <Substitution type="package" search="http://schemas.microsoft.com/office/word/2010/wordml" replace="w14"/>
+    <Substitution type="package" search="http://schemas.microsoft.com/office/word/2012/wordml" replace="w15"/>
+    <!--
+      docx4j CR-023 (schema refresh of 2026-09-20, CR-001 section 14.10): the
+      extensions Word writes on ISO elements, imported by wml.xsd. Two carry
+      classes and take docx4j's package names (org.docx4j.w15symex, whose
+      prefix is w16se, and org.docx4j.w16cid); the other three declare a
+      single global attribute each (w16du:dateUtc, w16sdtdh:storeItemChecksum,
+      w16sdtfl:formattingAllowed), which the generator binds as fields of the
+      classes that reference them, so no module is written for them and the
+      entries are here for the day one of them gains an element.
+    -->
+    <Substitution type="package" search="http://schemas.microsoft.com/office/word/2015/wordml/symex" replace="w15symex"/>
+    <Substitution type="package" search="http://schemas.microsoft.com/office/word/2016/wordml/cid" replace="w16cid"/>
+    <Substitution type="package" search="http://schemas.microsoft.com/office/word/2020/wordml/sdtdatahash" replace="w16sdtdh"/>
+    <Substitution type="package" search="http://schemas.microsoft.com/office/word/2023/wordml/word16du" replace="w16du"/>
+    <Substitution type="package" search="http://schemas.microsoft.com/office/word/2024/wordml/sdtformatlock" replace="w16sdtfl"/>
+    <Substitution type="package" search="http://schemas.microsoft.com/office/word/2010/wordprocessingCanvas" replace="word.wpc"/>
+    <Substitution type="package" search="http://schemas.microsoft.com/office/word/2010/wordprocessingDrawing" replace="word.wp14"/>
+    <Substitution type="package" search="http://schemas.microsoft.com/office/word/2010/wordprocessingGroup" replace="word.wpg"/>
+    <Substitution type="package" search="http://schemas.microsoft.com/office/word/2010/wordprocessingShape" replace="word.wps"/>
+    <Substitution type="package" search="http://schemas.microsoft.com/office/word/2012/wordprocessingDrawing" replace="word.wp15"/>
+    <Substitution type="package" search="http://schemas.microsoft.com/ink/2010/main" replace="word.msink"/>
+
+    <!-- Microsoft drawing extensions, docx4j's xsd/odrawxml -->
+    <Substitution type="package" search="http://schemas.microsoft.com/office/drawing/2007/8/2/chart" replace="oart.chart_2007"/>
+    <Substitution type="package" search="http://schemas.microsoft.com/office/drawing/2008/diagram" replace="oart.diagram_2008"/>
+    <Substitution type="package" search="http://schemas.microsoft.com/office/drawing/2010/main" replace="oart.main_2010"/>
+    <Substitution type="package" search="http://schemas.microsoft.com/office/drawing/2010/picture" replace="oart.picture_2010"/>
+    <Substitution type="package" search="http://schemas.microsoft.com/office/drawing/2010/diagram" replace="oart.diagram_2010"/>
+    <Substitution type="package" search="http://schemas.microsoft.com/office/drawing/2010/chartDrawing" replace="oart.chart_drawing_2010"/>
+    <Substitution type="package" search="http://schemas.microsoft.com/office/drawing/2012/main" replace="oart.main_2012"/>
+    <Substitution type="package" search="http://schemas.microsoft.com/office/drawing/2012/chart" replace="oart.chart_2012"/>
+    <Substitution type="package" search="http://schemas.microsoft.com/office/drawing/2012/chartStyle" replace="oart.chart_style_2012"/>
+    <Substitution type="package" search="http://schemas.microsoft.com/office/drawing/2013/main/command" replace="oart.command_2013"/>
+    <Substitution type="package" search="http://schemas.microsoft.com/office/drawing/2014/main" replace="oart.main_2014"/>
+    <Substitution type="package" search="http://schemas.microsoft.com/office/drawing/2014/chart" replace="oart.chart_2014"/>
+    <Substitution type="package" search="http://schemas.microsoft.com/office/drawing/2014/chart/ac" replace="oart.chart_ac_2014"/>
+    <Substitution type="package" search="http://schemas.microsoft.com/office/drawing/2014/chartex" replace="oart.chartex_2014"/>
+    <Substitution type="package" search="http://schemas.microsoft.com/office/drawing/2016/ink" replace="oart.ink_2016"/>
+    <Substitution type="package" search="http://schemas.microsoft.com/office/drawing/2016/SVG/main" replace="oart.svg_2016"/>
+    <Substitution type="package" search="http://schemas.microsoft.com/office/drawing/2016/11/main" replace="oart.main_2016_11"/>
+    <Substitution type="package" search="http://schemas.microsoft.com/office/drawing/2016/11/diagram" replace="oart.diagram_2016_11"/>
+    <Substitution type="package" search="http://schemas.microsoft.com/office/drawing/2016/12/diagram" replace="oart.diagram_2016_12"/>
+    <Substitution type="package" search="http://schemas.microsoft.com/office/drawing/2017/03/chart" replace="oart.chart_2017_03"/>
+    <Substitution type="package" search="http://schemas.microsoft.com/office/drawing/2017/decorative" replace="oart.decorative_2017"/>
+    <Substitution type="package" search="http://schemas.microsoft.com/office/drawing/2017/model3d" replace="oart.model3d_2017"/>
+    <Substitution type="package" search="http://schemas.microsoft.com/office/drawing/2018/animation" replace="oart.animation_2018"/>
+    <Substitution type="package" search="http://schemas.microsoft.com/office/drawing/2018/animation/model3d" replace="oart.animation_model3d_2018"/>
+    <Substitution type="package" search="http://schemas.microsoft.com/office/drawing/2018/hyperlinkcolor" replace="oart.hyperlink_color_2018"/>
+    <Substitution type="package" search="http://schemas.microsoft.com/office/excel/2010/spreadsheetDrawing" replace="oart.spreadsheet_drawing_2010"/>
+    <Substitution type="package" search="http://schemas.microsoft.com/office/powerpoint/2014/inkAction" replace="oart.ink_action_2014"/>
+    <Substitution type="package" search="http://schemas.microsoft.com/office/thememl/2012/main" replace="oart.theme_2012"/>
+  </Substitutions>
+  <Extensions>
+    <!--
+      CR-001 section 5: every generated dataclass gets the parent pointer.
+      applyIfDerived is left off on purpose, so a class that already extends a
+      generated class (RunIns over CT_RunTrackChange) inherits Child from its
+      base instead of listing it twice. Enumerations use a different template
+      and are not touched.
+    -->
+    <Extension type="class" class=".*" import="docx4j_py.child.Child"/>
+  </Extensions>
+</Config>

docx4j-0.1.0/CHANGELOG.md

@@ -0,0 +1,89 @@
+# Changelog
+
+The distribution `docx4j` (import name `docx4j_py`), on PyPI at
+<https://pypi.org/project/docx4j/>. The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/)
+and the versions [Semantic Versioning](https://semver.org/) as far as `0.x` goes: what each
+surface promises in `0.x` is the table at the end of this file. Each entry summarises what a
+change request delivered and links the CR's own implementation notes, which are the record; the
+CRs are under [`docs/change-requests/`](docs/change-requests/README.md).
+
+## [0.1.0] --- 2026-09-20
+
+The first release: WordprocessingML only. `.pptx` and `.xlsx` load and save through the generic
+OPC path with every part byte for byte, but nothing in them is typed; PresentationML and
+SpreadsheetML are CR-001 Phase D and CR-002 Phase C, for `0.2` and `0.3`.
+
+### Added
+
+- **The object model** ([CR-001](docs/change-requests/CR-001-object-model.md), Phases A to C,
+  sections [12](docs/change-requests/CR-001-object-model.md#12-phase-a-implementation-notes-2026-09-12),
+  [13](docs/change-requests/CR-001-object-model.md#13-phase-b-implementation-notes-2026-09-12) and
+  [14](docs/change-requests/CR-001-object-model.md#14-phase-c-implementation-notes-2026-09-12)):
+  the whole of WordprocessingML and what it embeds (DrawingML, OMML, VML, `w14` to `w16`, the
+  relationships and `docProps` schemas) as slotted dataclasses generated from docx4j's own schema
+  tree by the xsdata fork, one package per namespace under docx4j's class names; every object a
+  `Child` with a parent pointer and `deep_copy`; the `el` object factory (2,061 element names over
+  63 namespaces), the `p` / `r` / `t` / `tbl` sugar, `wml(...)` fragments and `to_xml`, `walk`,
+  `find`, `text_of` and the rest of the traversal; lenient parsing with a per-part skipped-content
+  report; `warm_up()`; docx4j's prefix table. Refreshed to docx4j `c363a969f` on 2026-09-20
+  ([14.10](docs/change-requests/CR-001-object-model.md#1410-schema-refresh-2026-09-20) and
+  [14.11](docs/change-requests/CR-001-object-model.md#1411-follow-up-refresh-to-docx4j-c363a969f-2026-09-20)).
+- **The Open Packaging engine** ([CR-002](docs/change-requests/CR-002-engine.md), Phases A and B,
+  sections [12](docs/change-requests/CR-002-engine.md#12-phase-a-implementation-notes-2026-09-12)
+  and [15](docs/change-requests/CR-002-engine.md#15-phase-b-implementation-notes-2026-09-19)):
+  `PartStore` and `PartSink` (zip, directory, memory, flat OPC), `PartName`, content types,
+  relationships, typed parts with lazy `contents`, `load` and `save` with every untouched part
+  written back byte for byte and every re-marshalled one canonically identical to its source,
+  lossless `mc:AlternateContent` with a resolving traversal, `mc:Ignorable` on write,
+  `create_package` (Word 2013+ compatibility mode, a theme part); and docx4j's resolution
+  utilities --- `PropertyResolver` and `StyleUtil` over a property catalogue, the numbering
+  emulator, and `org.docx4j.fonts`' decision half --- with zero differences on all 45 of docx4j's
+  parity goldens. Departures from docx4j are section 12.3.
+- **The content API** ([CR-003](docs/change-requests/CR-003-content-api.md), every phase,
+  sections [10](docs/change-requests/CR-003-content-api.md#10-phase-a-implementation-notes-2026-09-16)
+  to [20](docs/change-requests/CR-003-content-api.md#20-phase-j-implementation-notes-2026-09-18)):
+  `Body`, `Paragraph`, `Range`, `Font`, `Table`, `TableRow`, `TableCell`, `InlinePicture`,
+  `ContentControl`, `Comment`, `TrackedChange`, `List` and `ListItem` in Office JS's vocabulary;
+  the agent surface --- paraId-first addresses, `outline()`, `find()`, `describe()`, a
+  `ChangeReport` on every mutating call, `dry_run`, `DocumentSession`, errors with a `code` and a
+  `hint`; markdown out and in with addresses; tracked changes and comments as the audit trail, with
+  `accept_all()` and `reject_all()`; custom XML parts, XML mapping and the typed content-control
+  kinds with `describe()` / `fill()` for templates; `insert_ooxml` from a flat OPC package;
+  `to_api_script`, the reveal codes; and the **python-docx facade** `docx4j_py.docx` (305 of
+  python-docx 1.2.0's 312 members, a parity test with python-docx as the judge).
+- **Packaging** ([CR-007](docs/change-requests/CR-007-pypi-release.md), Phase B, section 10):
+  the distribution `docx4j` with `py.typed`, `NOTICE`, this changelog, `RELEASING.md`, a short PyPI
+  readme whose every example the suite executes (`tests/test_readme.py`), CI on Python 3.12 to
+  3.14, and `scripts/release_check.sh`, which builds the wheel and gates it in a clean environment.
+
+### Dependencies
+
+- `docx4j-xsdata[lxml] >=26.2.1,<26.3` --- the xsdata fork the generated modules import, published
+  as [docx4j-xsdata 26.2.1](https://pypi.org/project/docx4j-xsdata/26.2.1/) by CR-007 Phase A
+  (section 9). The upper bound is where the fork's upstream base moves and the bindings are
+  regenerated.
+- `markdown-it-py >=3.0`, imported on the first `insert_markdown`.
+- Python 3.12 or later.
+
+### Notes
+
+- **One generated field name is not what an earlier checkout had**: the `w:rPr` of `m:ctrlPr`
+  (`math.CTCtrlPr`) was `schemas_openxmlformats_org_wordprocessingml_2006_main_r_pr` and is
+  `r_pr_1`, with the `a:rPr` docx4j CR-025 admitted as `r_pr_2` (CR-001 section 14.11). Nothing
+  released carried the old name, so this is a note, not a breaking change.
+- `from docx4j_py.wml import sdt` is the content-control builder until something imports the
+  module `docx4j_py.wml.sdt`, after which it is the module (CR-003 section 11.5); write
+  `from docx4j_py.wml.sdt import sdt`, which is unambiguous.
+
+### What `0.x` promises
+
+| Surface | Stability in `0.x` |
+|---|---|
+| `docx4j_py.load`, `create_package`, `WordprocessingMLPackage`, the parts, `PartStore` / `PartSink` | Stable: docx4j's names and behaviour; departures are recorded in CR-002 section 12.3 |
+| The content API (`Body`, `Paragraph`, `Range`, `Table`, ..., the agent surface, markdown) | Stable in shape: Office JS's vocabulary is borrowed, not invented; a member may be added in a minor, none renamed |
+| `docx4j_py.docx`, the python-docx facade | Stable: its promise is `tests/python_docx_subset.json`, 305 of 312 members |
+| The generated model (`docx4j_py.wml` and the rest, `el`) | Regenerates with the schema; class and field names are docx4j's and do not move, but a schema refresh adds fields and classes in a minor |
+| `docx4j_py.model` (resolver, `StyleUtil`, fonts, numbering) | Stable: docx4j's, zero differences on the goldens |
+| Anything under `codegen/`, `scripts/`, `baseline/` | Not shipped in the wheel; in the source distribution for the suite |
+
+[0.1.0]: https://github.com/plutext/docx4j-python/releases/tag/v0.1.0

docx4j-0.1.0/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

docx4j-0.1.0/NOTICE

@@ -0,0 +1,41 @@
+docx4j (for Python; import name docx4j_py)
+Copyright 2026 Plutext Pty Ltd
+
+Licensed under the Apache License, Version 2.0 (see LICENSE).
+
+This package is a Python counterpart of docx4j (https://github.com/plutext/docx4j,
+Apache License 2.0): the object model is generated from docx4j's own schema tree and
+carries docx4j's class names; the Open Packaging layer (packages, parts, relationships,
+content types), the typed parts, and the style, numbering and font resolution follow
+docx4j's design and names. The design is shared with @docx4j/core-ts
+(https://github.com/plutext/docx4j-core-ts, Apache License 2.0).
+
+The wheel carries these files taken from docx4j's docx4j-core module (Apache License
+2.0), under docx4j_py/resources/:
+
+  KnownStyles.xml                     org/docx4j/openpackaging/parts/WordprocessingML/KnownStyles.xml,
+                                      Word's built-in style definitions as docx4j ships them
+  openpackaging/styles.xml            docx4j's default styles, numbering and font table for a new
+  openpackaging/numbering.xml         document, from the same directory (transcoded to UTF-8)
+  openpackaging/fontTable.xml
+  fonts/theme-2007.xml                the three Office theme parts, from the same directory, byte
+  fonts/theme-2013.xml                for byte
+  fonts/theme-2023.xml
+  fonts/substitutions.json            docx4j's font substitution tables (org/docx4j/fonts/
+  fonts/families.json                 font-substitutes.xml, substitutions/FontSubstitutions.xml,
+  fonts/registry.json                 microsoft/MicrosoftFonts.xml, word-line-metrics.properties)
+                                      as JSON, written by scripts/generate_fonts.py; each file's
+                                      _source object names the docx4j commit it was read from
+
+The warm-up parts (warmup_document.xml, warmup_styles.xml) were written for this package.
+
+The generated modules import docx4j-xsdata (https://github.com/plutext/docx4j-xsdata), a
+fork of xsdata (https://github.com/tefra/xsdata, Copyright Christodoulos Tsoulloftas),
+which is a dependency of this package and is distributed under the MIT License; it is not
+included in this distribution.
+
+The XML schemas the object model is generated from (schemas/ in the source distribution,
+not in the wheel) are ECMA-376 Office Open XML's, as docx4j's xsd tree carries them, with
+the patches listed in schemas/PATCHES.md; they keep the terms stated in their own headers.
+The sample documents under samples/ and tests/fixtures/ (source distribution only) are
+docx4j's test fixtures, Apache License 2.0.