npm - @pretextbook/pretext-html - Versions diffs - 0.1.0 - Mend

@pretextbook/pretext-html 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (110) hide show

package/README.md +160 -0
package/assets/preview-html.xsl +230 -0
package/assets/upstream.json +7 -0
package/assets/xsl/README.md +31 -0
package/assets/xsl/entities.ent +154 -0
package/assets/xsl/extract-asymptote.xsl +68 -0
package/assets/xsl/extract-biblio-csl.xsl +327 -0
package/assets/xsl/extract-datafile.xsl +71 -0
package/assets/xsl/extract-dynamic.xsl +139 -0
package/assets/xsl/extract-identity.xsl +136 -0
package/assets/xsl/extract-interactive.xsl +81 -0
package/assets/xsl/extract-latex-image.xsl +118 -0
package/assets/xsl/extract-mermaid.xsl +58 -0
package/assets/xsl/extract-mom.xsl +63 -0
package/assets/xsl/extract-pg.xsl +2897 -0
package/assets/xsl/extract-prefigure.xsl +157 -0
package/assets/xsl/extract-qrcode.xsl +100 -0
package/assets/xsl/extract-runestone-page-template.xsl +139 -0
package/assets/xsl/extract-sageplot.xsl +166 -0
package/assets/xsl/extract-stack.xsl +56 -0
package/assets/xsl/extract-trace.xsl +134 -0
package/assets/xsl/extract-youtube.xsl +63 -0
package/assets/xsl/html-symbols.xsl +3344 -0
package/assets/xsl/latex/pretext-latex-AIM.xsl +56 -0
package/assets/xsl/latex/pretext-latex-CLP.xsl +148 -0
package/assets/xsl/latex/pretext-latex-chaos.xsl +317 -0
package/assets/xsl/latex/pretext-latex-dyslexic-font.xsl +76 -0
package/assets/xsl/latex/pretext-latex-guide.xsl +104 -0
package/assets/xsl/latex/pretext-latex-texstyle.xsl +862 -0
package/assets/xsl/localizations/README.md +56 -0
package/assets/xsl/localizations/af-ZA.xml +276 -0
package/assets/xsl/localizations/bg-BG.xml +276 -0
package/assets/xsl/localizations/ca-ES.xml +285 -0
package/assets/xsl/localizations/cs-CZ.xml +280 -0
package/assets/xsl/localizations/de-DE.xml +281 -0
package/assets/xsl/localizations/en-US.xml +427 -0
package/assets/xsl/localizations/es-ES.xml +287 -0
package/assets/xsl/localizations/fi-FI.xml +275 -0
package/assets/xsl/localizations/fr-CA.xml +276 -0
package/assets/xsl/localizations/fr-FR.xml +280 -0
package/assets/xsl/localizations/hu-HU.xml +280 -0
package/assets/xsl/localizations/it-IT.xml +276 -0
package/assets/xsl/localizations/ku-CKB.xml +275 -0
package/assets/xsl/localizations/localizations.xml +48 -0
package/assets/xsl/localizations/nl-NL.xml +275 -0
package/assets/xsl/localizations/pt-BR.xml +288 -0
package/assets/xsl/localizations/pt-PT.xml +292 -0
package/assets/xsl/localizations/zh-HANS.xml +269 -0
package/assets/xsl/pretext-assembly.xsl +4795 -0
package/assets/xsl/pretext-basic-html.xsl +86 -0
package/assets/xsl/pretext-beamer.xsl +662 -0
package/assets/xsl/pretext-braille-preprint.xsl +2249 -0
package/assets/xsl/pretext-common.xsl +12018 -0
package/assets/xsl/pretext-dynamic.xsl +65 -0
package/assets/xsl/pretext-epub.xsl +1483 -0
package/assets/xsl/pretext-fo.xsl +4593 -0
package/assets/xsl/pretext-html.xsl +14791 -0
package/assets/xsl/pretext-json-manifest.xsl +150 -0
package/assets/xsl/pretext-jupyter.xsl +868 -0
package/assets/xsl/pretext-latex-classic.xsl +952 -0
package/assets/xsl/pretext-latex-common.xsl +11563 -0
package/assets/xsl/pretext-latex.xsl +47 -0
package/assets/xsl/pretext-litprog.xsl +105 -0
package/assets/xsl/pretext-merge.xsl +41 -0
package/assets/xsl/pretext-numbers.xsl +875 -0
package/assets/xsl/pretext-revealjs.xsl +522 -0
package/assets/xsl/pretext-runestone-fitb.xsl +1233 -0
package/assets/xsl/pretext-runestone-static.xsl +1438 -0
package/assets/xsl/pretext-runestone.xsl +3083 -0
package/assets/xsl/pretext-sage-doctest.xsl +289 -0
package/assets/xsl/pretext-smc.xsl +492 -0
package/assets/xsl/pretext-solution-manual-latex.xsl +323 -0
package/assets/xsl/pretext-text-utilities.xsl +1217 -0
package/assets/xsl/pretext-text.xsl +392 -0
package/assets/xsl/pretext-units.xsl +195 -0
package/assets/xsl/pretext-view-source.xsl +157 -0
package/assets/xsl/pretext-ww-problem-sets.xsl +391 -0
package/assets/xsl/publisher-variables.xsl +4756 -0
package/assets/xsl/support/README.md +22 -0
package/assets/xsl/support/extract-math.xsl +256 -0
package/assets/xsl/support/package-math.xsl +141 -0
package/assets/xsl/support/play-button/README.md +46 -0
package/assets/xsl/support/play-button/play-button.png +0 -0
package/assets/xsl/support/play-button/play-button.svg +3 -0
package/assets/xsl/support/pretext-pg-macros.xsl +110 -0
package/assets/xsl/support/webpack_static_imports.xml +14 -0
package/assets/xsl/tests/README.md +24 -0
package/assets/xsl/tests/null.xml +4 -0
package/assets/xsl/tests/pretext-text-utilities-test.xsl +334 -0
package/assets/xsl/utilities/README.md +31 -0
package/assets/xsl/utilities/author-report.xsl +107 -0
package/assets/xsl/utilities/deprecate-autoname.sed +18 -0
package/assets/xsl/utilities/deprecate-index.sed +33 -0
package/assets/xsl/utilities/fix-deprecations.xsl +663 -0
package/assets/xsl/utilities/pretext-enhanced-source.xsl +112 -0
package/assets/xsl/utilities/report-publisher-variables.xsl +162 -0
package/assets/xsl/xml-to-json.xsl +326 -0
package/assets/xsl/xml-to-string.xsl +328 -0
package/cli.mjs +29 -0
package/dist/cli-C6tfAVvi.js +553 -0
package/dist/cli.d.ts +10 -0
package/dist/cli.js +7 -0
package/dist/index.d.ts +6 -0
package/dist/index.js +10 -0
package/dist/mounts.d.ts +23 -0
package/dist/publication.d.ts +16 -0
package/dist/renderer.d.ts +84 -0
package/dist/sourcemap.d.ts +41 -0
package/dist/xinclude.d.ts +45 -0
package/package.json +52 -0

package/README.md ADDED Viewed

@@ -0,0 +1,160 @@
+# @pretextbook/pretext-html
+Convert [PreTeXt](https://pretextbook.org) documents to HTML in pure
+JavaScript — no Python, no PreTeXt installation. This runs the **official,
+unmodified PreTeXt XSLT stylesheets** with
+[`@pretextbook/libxslt-wasm`](https://github.com/oscarlevin/libxslt-wasm), a
+WebAssembly build of libxml2/libxslt/libexslt (the same C libraries the Python
+CLI uses via lxml), so the HTML matches a real `pretext build`. It is a fork of
+[jeremy-code/libxslt-wasm](https://github.com/jeremy-code/libxslt-wasm) built
+with a larger WASM stack so whole-book documents render without overflowing
+(see [Forking libxslt-wasm](#forking-libxslt-wasm)).
+The output is a single, standalone HTML page: PreTeXt's _portable HTML_ mode
+is forced on, so theme css/js and MathJax load from public CDNs and the whole
+document is rendered as one page. This is what powers the "Instant Preview"
+in the PreTeXt-tools VS Code extension, and it is published so other tools
+(e.g. pretext.plus) can render previews the same way.
+## Usage
+### CLI
+```sh
+npx @pretextbook/pretext-html source/main.ptx \
+  --project-dir . \
+  --publication publication/publication.ptx \
+  -o preview.html
+```
+HTML goes to stdout (or `--output`); diagnostics (`PTX:WARNING`, `PTX:ERROR`,
+deprecation notices) go to stderr. Run `pretext-html --help` for all options.
+The CLI relaunches itself with `--experimental-wasm-jspi` automatically (see
+[Requirements](#requirements)).
+### API (Node)
+```js
+import { renderHtml } from "@pretextbook/pretext-html";
+const { html } = await renderHtml({
+  sourcePath: "source/main.ptx", // root document
+  projectDir: ".", // directory the transform may read from
+  publicationPath: "publication/publication.ptx", // optional
+  stringParams: {}, // optional extra XSLT stringparams
+});
+```
+- `sourceContent` lets you render unsaved editor text (with `sourcePath` still
+  anchoring relative `xi:include`s).
+- `fragment: true` renders a non-root file (a lone `<section>`, `<chapter>`, …)
+  by wrapping it in a minimal `<pretext>` document. To keep the project's LaTeX
+  macros and custom settings, give it the docinfo: either `docinfoSourcePath`
+  (the project main file, whose `<docinfo>` is lifted out — resolving
+  `xi:include`s, including a docinfo that is itself included), or `docinfo` (a
+  `<docinfo>` element as a string, if you already have it). Both are ignored
+  for complete documents, which carry their own docinfo.
+- `sourceMap: true` additionally returns a **source map** for editor/preview
+  sync: one entry per element, in document order, mapping the element's HTML
+  id to the source `file`/`line` it was authored in — through `xi:include`s.
+  This works because HTML ids are the `@unique-id` values that
+  `pretext-assembly.xsl` stamps with a deterministic walk
+  (`@label ?? @xml:id ?? parent-id + "-" + sibling-position`), which is
+  replicated over the merged tree in JS; the rendered page itself is
+  unchanged. Entries carry a `parent` id so clients can fall outward when an
+  element has no HTML id of its own, and `findSourceMapEntry(entries, line)`
+  picks the element nearest a cursor line. (This powers the two-way sync in
+  the VS Code Instant Preview; the same map works for any embedder.)
+- The user's publication file is respected, except
+  `<html><platform portable="yes"/></html>` is always forced — that is what
+  makes single-page in-memory output possible.
+- The compiled stylesheet is cached per `xslDir` (~1s to compile, then
+  ~100ms–1s per render depending on document size).
+## Requirements
+- **Node ≥ 22** launched with **`--experimental-wasm-jspi`** (WebAssembly
+  stack switching). The flag is not allowed in `NODE_OPTIONS`; it must be on
+  the command line. The `pretext-html` CLI re-executes itself with the flag;
+  API users must supply it themselves (in tests, vitest's `execArgv` option
+  works — see `vite.config.mts`).
+- Runtimes with V8 ≥ 13.7 (Chromium/Electron ≥ 137, and eventually Node
+  itself) ship JSPI **enabled by default and reject the flag** as a bad
+  option. Feature-detect with `"Suspending" in WebAssembly` (exported as
+  `isJspiAvailable()`) before adding the flag rather than assuming it is
+  needed.
+- Network access _for the rendered page_ (theme css/js and MathJax come from
+  `cdn.jsdelivr.net`). The transform itself runs fully offline.
+## How it works
+1. **Vendored stylesheets** — `assets/xsl/` is a snapshot of the upstream
+   [`pretext/xsl`](https://github.com/PreTeXtBook/pretext/tree/master/xsl)
+   tree (GPL-licensed; see `assets/xsl/LICENSE-pretext`). Refresh with
+   `npm run refresh:xsl` from the monorepo root.
+2. **Generated wrapper** — `assets/preview-html.xsl` imports `pretext-html.xsl`
+   and overrides the `file-wrap` template with a verbatim copy minus its
+   `<exsl:document>` wrapper, so the complete page (head, theme links,
+   masthead, content) lands on the main result tree instead of on disk. All
+   other file-writing templates are stubbed. The wrapper is **generated** by
+   `scripts/refresh-xsl.mjs`, which also audits every `exsl:document` site
+   reachable from `pretext-html.xsl` and fails if upstream adds a writer we
+   don't cover.
+3. **Virtual-host fetch shim** — the WASM build has no filesystem
+   (`FILESYSTEM=0`); every resource load (stylesheet imports, `document()`
+   calls, the publication file) goes through the global `fetch`. We mount
+   fake origins like `http://mnt1.ptx.invalid` backed by local directories
+   and in-memory strings — no HTTP server involved.
+4. **JS XInclude** — `xi:include` is resolved in JavaScript before parsing
+   (libxml2's own XInclude pass cannot suspend in the current WASM build).
+   Supports nested includes, `parse="text"`, and `xi:fallback`; `xpointer` is
+   not supported.
+## Limitations (current WASM build)
+| Limitation                                     | Cause                                           | Fix                                                                         |
+| ---------------------------------------------- | ----------------------------------------------- | --------------------------------------------------------------------------- |
+| No multi-file output (`exsl:document`)         | Compiled with `FILESYSTEM=0`                    | Rebuild with `FILESYSTEM=1` (files land in MEMFS)                           |
+| Node only, JSPI flag required                  | Loader fetches resources mid-transform via JSPI | Preload stylesheets into MEMFS at init, or wait for JSPI to ship unflagged  |
+| No generated images (latex-image, sageplot, …) | Produced by the Python toolchain, not XSLT      | Out of scope; run `pretext generate` and the preview will pick the files up |
+| `xi:include` with `xpointer` unsupported       | JS resolver stands in for libxml2's             | Rebuild adding `xmlXIncludeProcessFlags` to the JSPI export list            |
+The whole-book stack overflow ("memory access out of bounds") that the stock
+`libxslt-wasm` build hit on large documents is **fixed** in the
+`@pretextbook/libxslt-wasm` fork, which links with a larger WASM stack.
+Missing generated assets degrade gracefully: the transform serves a stub for
+missing files, PreTeXt emits its usual `PTX:ERROR` advice, and the preview
+renders without the image.
+## Forking libxslt-wasm
+This package depends on [`@pretextbook/libxslt-wasm`](https://github.com/oscarlevin/libxslt-wasm),
+a fork of [jeremy-code/libxslt-wasm](https://github.com/jeremy-code/libxslt-wasm)
+(MIT) rebuilt with different Emscripten link flags. The remaining limitations
+above are also flag changes, not architecture — when ready to tackle them:
+- `-sSTACK_SIZE` (already raised in the fork) — fixes whole-book stack
+  overflows; pair with `-sALLOW_MEMORY_GROWTH=1`.
+- `-sFILESYSTEM=1` — enables `exsl:document` writes into in-memory MEMFS,
+  readable back from JS; unlocks real multi-file builds.
+- Add `xmlXIncludeProcessFlags` to the JSPI exports list (the `Asyncify`/JSPI
+  `exportPattern` — see `ASYNCIFY_EXPORTS` in the build) so native XInclude can
+  suspend for fetches; then the JS resolver in `src/xinclude.ts` can be retired.
+- To drop the JSPI requirement entirely (needed for Firefox/Safari/browser
+  use): preload `assets/xsl/` into MEMFS at module init so no fetch happens
+  mid-transform, and switch the entity loader to synchronous MEMFS reads.
+**Refreshing the fork:** rebuild the WASM in the fork, `npm version` + `npm
+publish` it, then bump the `@pretextbook/libxslt-wasm` version in this
+package's `package.json`. Everything else — wrapper stylesheet, mounts, API —
+stays the same.
+## Development
+```sh
+npm run build -w @pretextbook/pretext-html    # vite build to dist/
+npm run test -w @pretextbook/pretext-html     # vitest (JSPI via execArgv)
+npm run refresh:xsl                            # re-vendor xsl + regenerate wrapper (from repo root)
+```

package/assets/preview-html.xsl ADDED Viewed

@@ -0,0 +1,230 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+  GENERATED FILE - do not edit by hand.
+  Regenerate with: npm run refresh-xsl -w @pretextbook/pretext-html
+  Wrapper around pretext-html.xsl for single-page in-memory HTML builds
+  (previews). The "file-wrap" template below is a verbatim copy of the
+  upstream template with the <exsl:document> element removed, so the complete
+  page is emitted on the main result tree. Intended to be applied together
+  with a publication file that sets <html><platform portable="yes"/></html>,
+  which forces chunk level 0 (one page) and CDN-hosted css/js, and suppresses
+  most auxiliary file output. Remaining file writers are stubbed at the end.
+-->
+<xsl:stylesheet
+    xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0"
+    xmlns:xml="http://www.w3.org/XML/1998/namespace"
+    xmlns:svg="http://www.w3.org/2000/svg"
+    xmlns:xlink="http://www.w3.org/1999/xlink"
+    xmlns:pi="http://pretextbook.org/2020/pretext/internal"
+    xmlns:exsl="http://exslt.org/common"
+    xmlns:date="http://exslt.org/dates-and-times"
+    xmlns:str="http://exslt.org/strings"
+    xmlns:fn="http://www.w3.org/2005/xpath-functions"
+    xmlns:pf="https://prefigure.org"
+    exclude-result-prefixes="svg xlink pi fn pf"
+    extension-element-prefixes="exsl date str"
+>
+<xsl:import href="pretext-html.xsl"/>
+<xsl:output method="html" encoding="UTF-8" doctype-system="about:legacy-compat"/>
+<!-- Copied from pretext-html.xsl (mode="file-wrap"), exsl:document removed -->
+<xsl:template match="*" mode="file-wrap">
+    <xsl:param name="content" />
+    <xsl:param name="title" select="''"/>
+    <xsl:param name="filename" select="''"/>
+    <xsl:param name="b-has-printout" select="false()"/>
+    <xsl:param name="b-include-bottom-nav" select="true()"/>
+    <xsl:variable name="the-filename">
+        <xsl:choose>
+            <xsl:when test="not($filename = '')">
+                <xsl:value-of select="$filename"/>
+            </xsl:when>
+            <xsl:otherwise>
+                <xsl:apply-templates select="." mode="containing-filename" />
+            </xsl:otherwise>
+        </xsl:choose>
+    </xsl:variable>
+    <xsl:call-template name="converter-blurb-html-no-date"/>
+    <html>
+        <xsl:call-template name="language-attributes"/>
+        <xsl:call-template name="html-theme-attributes"/>
+        <xsl:call-template name="pretext-advertisement-and-style"/>
+        <!-- Open Graph Protocol only in "meta" elements, within "head" -->
+        <head xmlns:og="http://ogp.me/ns#" xmlns:book="https://ogp.me/ns/book#">
+            <!-- optional head content that needs to come prior to other content -->
+            <xsl:apply-templates select="." mode="file-wrap-head-pre"/>
+            <title>
+                <xsl:choose>
+                    <xsl:when test="$title != ''">
+                        <xsl:value-of select="$title"/>
+                    </xsl:when>
+                    <xsl:otherwise>
+                        <!-- Leading with initials is useful for small tabs -->
+                        <xsl:if test="$docinfo/initialism">
+                            <xsl:apply-templates select="$docinfo/initialism" />
+                            <xsl:text> </xsl:text>
+                        </xsl:if>
+                        <xsl:apply-templates select="." mode="title-plain" />
+                    </xsl:otherwise>
+                </xsl:choose>
+            </title>
+            <!-- canonical link for better SEO -->
+            <xsl:call-template name="canonical-link">
+                <xsl:with-param name="filename" select="$the-filename"/>
+            </xsl:call-template>
+            <!-- grab the contents every page gets -->
+            <xsl:copy-of select="$file-wrap-full-head-cache"/>
+            <!-- now do anything that is or could be page-specific and comes after cache -->
+            <xsl:apply-templates select="." mode="knowl" />
+            <!-- webwork's iframeResizer needs to come before sagecell template -->
+            <xsl:apply-templates select="." mode="sagecell" />
+            <!-- optional head content that might override other content-->
+            <xsl:apply-templates select="." mode="file-wrap-head-post"/>
+        </head>
+        <body>
+            <xsl:if test="$b-has-stack">
+                <xsl:attribute name="onload">
+                    <xsl:text>docHasLoaded()</xsl:text>
+                </xsl:attribute>
+            </xsl:if>
+            <!-- potential document-id per-page -->
+            <xsl:call-template name="document-id"/>
+            <!-- React flag -->
+            <xsl:call-template name="react-in-use-flag"/>
+            <!-- the first class controls the default icon -->
+            <xsl:attribute name="class">
+                <xsl:choose>
+                    <xsl:when test="$root/book">pretext book</xsl:when>
+                    <xsl:when test="$root/article">pretext article</xsl:when>
+                </xsl:choose>
+                <xsl:apply-templates select="." mode="file-wrap-body-attr-extra"/>
+                <!-- ignore MathJax signals everywhere, then enable selectively -->
+                <xsl:text> ignore-math</xsl:text>
+            </xsl:attribute>
+            <!-- assistive "Skip to main content" link    -->
+            <!-- this *must* be first for maximum utility -->
+            <xsl:call-template name="skip-to-content-link" />
+            <!-- HTML5 body/header will be a "banner" landmark automatically -->
+            <header id="ptx-masthead" class="ptx-masthead">
+                <div class="ptx-banner">
+                    <xsl:call-template name="brand-logo" />
+                    <div class="title-container">
+                        <h1 class="heading">
+                            <xsl:variable name="root-filename">
+                                <xsl:apply-templates select="$document-root" mode="containing-filename" />
+                            </xsl:variable>
+                            <a href="{$root-filename}">
+                                <xsl:variable name="b-has-subtitle" select="boolean($document-root/subtitle)"/>
+                                <span class="title">
+                                    <!-- Do not use shorttitle in masthead,  -->
+                                    <!-- which is much like cover of a book  -->
+                                    <xsl:apply-templates select="$document-root" mode="title-simple" />
+                                </span>
+                                <xsl:if test="$b-has-subtitle and $b-html-banner-subtitle">
+                                    <xsl:text> </xsl:text>
+                                    <span class="subtitle">
+                                        <xsl:apply-templates select="$document-root" mode="subtitle" />
+                                    </span>
+                                </xsl:if>
+                            </a>
+                        </h1>
+                        <!-- Serial list of authors/editors -->
+                        <xsl:if test="$b-html-banner-byline">
+                            <p class="byline">
+                                <xsl:apply-templates select="$bibinfo/author" mode="name-list"/>
+                                <xsl:apply-templates select="$bibinfo/editor" mode="name-list"/>
+                            </p>
+                        </xsl:if>
+                    </div>  <!-- title-container -->
+                </div>  <!-- banner -->
+            </header>  <!-- masthead -->
+            <xsl:apply-templates select="." mode="primary-navigation"/>
+            <xsl:apply-templates select="." mode="latex-macros"/>
+            <div class="ptx-page">
+                <xsl:apply-templates select="." mode="sidebars" />
+                <!-- HTML5 main will be a "main" landmark automatically -->
+                <main class="ptx-main">
+                    <xsl:if test="$b-watermark">
+                        <xsl:attribute name="style">
+                            <xsl:value-of select="$watermark-css"/>
+                        </xsl:attribute>
+                    </xsl:if>
+                    <div id="ptx-content" class="ptx-content">
+                        <xsl:if test="$b-has-printout">
+                            <xsl:apply-templates select="." mode="print-preview-header"/>
+                        </xsl:if>
+                        <!-- Alternative to "copy-of": convert $content to a  -->
+                        <!-- node-set, and then hit with an identity template -->
+                        <!-- to duplicate.  Experiment indicates no change in -->
+                        <!-- output. (2023-01-11)                             -->
+                        <xsl:copy-of select="$content" />
+                    </div>
+                    <xsl:if test="$b-include-bottom-nav">
+                        <div id="ptx-content-footer" class="ptx-content-footer">
+                            <xsl:apply-templates select="." mode="previous-button"/>
+                            <xsl:variable name="top-localization">
+                                <xsl:apply-templates select="." mode="type-name">
+                                    <xsl:with-param name="string-id" select="'top'"/>
+                                </xsl:apply-templates>
+                            </xsl:variable>
+                            <a class="top-button button" href="#" title="{$top-localization}">
+                                <xsl:call-template name="insert-symbol">
+                                    <xsl:with-param name="name" select="'expand_less'"/>
+                                </xsl:call-template>
+                                <span class="name">
+                                    <xsl:value-of select="$top-localization"/>
+                                </span>
+                            </a>
+                            <xsl:apply-templates select="." mode="next-button"/>
+                        </div>
+                    </xsl:if>
+                </main>
+            </div>
+            <!-- formerly "extra" -->
+            <div id="ptx-page-footer" class="ptx-page-footer">
+                <xsl:apply-templates select="." mode="feedback-button"/>
+                <xsl:call-template name="pretext-link" />
+                <xsl:call-template name="runestone-link"/>
+                <xsl:call-template name="mathjax-link" />
+            </div>
+            <xsl:copy-of select="$file-wrap-full-endbody-cache"/>
+            <!-- For portable builds we stash the lunr search here -->
+            <xsl:if test="$b-portable-html and $has-native-search">
+                <xsl:call-template name="embedded-search-construction"/>
+            </xsl:if>
+            <!-- optional body content that needs to be inserted after all content -->
+            <!-- e.g. script tags to run immediately                               -->
+            <xsl:apply-templates select="." mode="file-wrap-body-post"/>
+        </body>
+    </html>
+</xsl:template>
+<!-- Stub out the remaining file writers (every other template reachable    -->
+<!-- from pretext-html.xsl that contains exsl:document). Under portable-    -->
+<!-- html several of these are already suppressed; the stubs cover the      -->
+<!-- rest and act as a safety net if publication settings change. Any       -->
+<!-- exsl:document that does fire aborts the FILESYSTEM=0 WASM build.       -->
+<xsl:template name="index-redirect-page"/>
+<xsl:template match="*" mode="manufacture-knowl"/>
+<xsl:template name="ol-marker-styles"/>
+<xsl:template name="doc-manifest"/>
+<xsl:template name="search-page-construction"/>
+<xsl:template name="scorm-manifest"/>
+<!-- standalone pages for videos and iframe pages for interactives -->
+<xsl:template match="*" mode="standalone-page"/>
+<xsl:template match="*" mode="create-iframe-page"/>
+<!-- runestone-manifest lives in pretext-runestone.xsl -->
+<xsl:template match="*" mode="runestone-manifest"/>
+<xsl:template match="*" mode="simple-file-wrap">
+    <xsl:param name="content"/>
+    <xsl:copy-of select="$content"/>
+</xsl:template>
+</xsl:stylesheet>

package/assets/upstream.json ADDED Viewed

@@ -0,0 +1,7 @@
+{
+  "source": {
+    "repository": "PreTeXtBook/pretext",
+    "ref": "master"
+  },
+  "refreshed": "2026-07-08T00:48:30.933Z"
+}

package/assets/xsl/README.md ADDED Viewed

@@ -0,0 +1,31 @@
+# eXtensible Stylesheet Language (XSL) Stylesheets
+XSL stylesheets are the primary vehicle for converting PreTeXt XML
+source into various output formats. As such, they are sometimes
+simply called "conversions." Here we list **some** of the available
+conversions, the list is not exhaustive. See _The PreTeXt Guide_
+for detailed documentation of use, in chapters of the part
+titled _Publisher's Guide_.
+- `pretext-latex.xsl` - conversion to LaTeX, which can then
+  be converted to PDF, in print or electronic flavors.
+- `pretext-html.xsl` - conversion to HTML for online use.
+- `pretext-epub.xsl` - conversion to EPUB, which
+  requires significant additional processing. So this stylesheet
+  is not meant to be applied in isolation. See the `pretext/pretext`
+  Python script for an option to initiate the processing pipeline.
+- `pretext-jupyter.xsl` - conversion to Jupyter notebooks.
+- `pretext-revealjs.xsl` - conversion of slideshows to HTML.
+- `pretext-beamer.xsl` - conversion of slideshows to PDF.
+- `pretext-braille.xsl` - conversion to a precursor for braille output, which
+  requires significant further processing. So this stylesheet
+  is not meant to be applied in isolation. See the `pretext/pretext`
+  Python script for an option to initiate the processing pipeline.
+- `pretext-common.xsl` - base templates, and not useful in isolation.
+- `pretext-assembly.xsl` - pre-processing stylesheet, which creates an
+  enhanced version of source. Applied in a controlled way by other stylesheets.
+  See the `utilities\pretext-enhanced-source.xsl` stylesheet for a demonstration.
+- `extract-*.xsl` - used to isolate particular parts of a PreTeXt
+  document, typically for subsequent processing by a script.
+(Updated: 2020-06-12)

package/assets/xsl/entities.ent ADDED Viewed

@@ -0,0 +1,154 @@
+<!-- ********************************************************************* -->
+<!-- Copyright 2016                                                        -->
+<!-- Robert A. Beezer                                                      -->
+<!--                                                                       -->
+<!-- This file is part of MathBook XML.                                    -->
+<!--                                                                       -->
+<!-- MathBook XML is free software: you can redistribute it and/or modify  -->
+<!-- it under the terms of the GNU General Public License as published by  -->
+<!-- the Free Software Foundation, either version 2 or version 3 of the    -->
+<!-- License (at your option).                                             -->
+<!--                                                                       -->
+<!-- MathBook XML 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 General Public License for more details.                          -->
+<!--                                                                       -->
+<!-- You should have received a copy of the GNU General Public License     -->
+<!-- along with MathBook XML.  If not, see <http://www.gnu.org/licenses/>. -->
+<!-- ********************************************************************* -->
+<!-- XSLT Cookbook, 2nd Edition                                     -->
+<!-- Copyright 2006, O'Reilly Media, Inc.                           -->
+<!-- Declaration and entity definition format from Recipe 2.8       -->
+<!-- Unicode strings from http://stackoverflow.com/questions/586231 -->
+<!ENTITY UPPERCASE "'ABCDEFGHIJKLMNOPQRSTUVWXYZÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖØÙÚÛÜÝÞŸŽŠŒ'">
+<!ENTITY LOWERCASE "'abcdefghijklmnopqrstuvwxyzàáâãäåæçèéêëìíîïðñòóôõöøùúûüýþÿžšœ'">
+<!-- Some more of our own design -->
+<!ENTITY DIGIT "'0123456789'">
+<!ENTITY ALPHABET "'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz'">
+<!ENTITY SIMPLECHAR "concat(&DIGIT;,&ALPHABET;)">
+<!-- for match/select -->
+<!ENTITY STRUCTURAL "book|article|slideshow|letter|memo|frontmatter|part|chapter|appendix|index|preface|acknowledgement|biography|foreword|dedication|colophon|section|subsection|subsubsection|slide|exercises|worksheet|handout|reading-questions|solutions|references|glossary|backmatter">
+<!ENTITY TRADITIONAL-DIVISION "book|article|part|chapter|section|subsection|subsubsection|appendix">
+<!ENTITY SPECIALIZED-DIVISION "exercises|worksheet|handout|reading-questions|references|glossary|solutions">
+<!-- for filtering nodes, eg *[&STRUCTURAL-FILTER;], *[not(&STRUCTURAL-FILTER;)] -->
+<!ENTITY STRUCTURAL-FILTER "self::book or self::article or self::slideshow or self::letter or self::memo or self::frontmatter or self::part or self::chapter or self::appendix or self::index or self::preface or self::acknowledgement or self::biography or self::foreword or self::dedication or self::colophon or self::section or self::subsection or self::subsubsection or self::slide or self::exercises or self::worksheet or self::handout or self::reading-questions or self::solutions or self::references or self::glossary or self::backmatter">
+<!ENTITY TRADITIONAL-DIVISION-FILTER "self::book or self::article or self::part or self::chapter or self::section or self::subsection or self::subsubsection or self::appendix">
+<!ENTITY SPECIALIZED-DIVISION-FILTER "self::exercises or self::worksheet or self::handout or self::reading-questions or self::references or self::glossary or self::solutions">
+<!-- NB: (2019-06-12)  Only the two metadata "filters" seem to          -->
+<!-- be in use, so only those are being maintained.  grep'ing on        -->
+<!-- METADATA v. METADATA-FILTER, and applying "wc" makes this evident. -->
+<!-- (Include this comment in count!)                                   -->
+<!-- typical items in blocks that get special treatment -->
+<!ENTITY METADATA "title|subtitle|caption|idx|index">
+<!ENTITY METADATA-FILTER "self::title or self::subtitle or self::caption or self::idx or self::index[not(index-list)]">
+<!-- Subdivisions and runs of paragraphs (like in a proof)  -->
+<!-- contain "invisible" items that get killed  and then    -->
+<!-- used/accessed other ways.  To see if something  is     -->
+<!--first, last, preceded, or followed by other significant -->
+<!-- items requires filtering out these items in forming a  -->
+<!-- node-set (so as to not be confused by their presence)  -->
+<!-- A super-lightweight "article" might have "frontmatter" -->
+<!-- and "backmatter" as peers of content elements, and in  -->
+<!-- other cases it should not be a problem                 -->
+<!-- Typical use:  *[not(&SUBDIVISION-METADATA-FILTER;)]    -->
+<!ENTITY SUBDIVISION-METADATA "title|subtitle|index|notation|todo|frontmatter|backmatter">
+<!ENTITY SUBDIVISION-METADATA-FILTER "self::title or self::subtitle or self::idx or self::index[not(index-list)] or self::notation or self::todo or self::frontmatter or self::backmatter">
+<!-- To implement a new category of blocks, search on    -->
+<!-- "PROJECT-" (case-sensitive) since we will mark      -->
+<!-- non-obvious locations with the string PROJECT-LIKE  -->
+<!-- as we immplement this on 2016-07-17, other entities -->
+<!-- below will also match this short form               -->
+<!-- definition, just a plain statement, but logically distinct -->
+<!ENTITY DEFINITION-LIKE "definition">
+<!ENTITY DEFINITION-FILTER "self::definition">
+<!-- statement + proof -->
+<!ENTITY THEOREM-LIKE "theorem|corollary|lemma|algorithm|proposition|claim|fact|identity">
+<!ENTITY THEOREM-FILTER "self::theorem or self::corollary or self::lemma or self::algorithm or self::proposition or self::claim or self::fact or self::identity">
+<!-- varieties of proofs -->
+<!ENTITY PROOF-LIKE "proof|argument|justification|reasoning|explanation">
+<!ENTITY PROOF-FILTER "self::proof or self::argument or self::justification or self::reasoning or self::explanation">
+<!-- three types of PROOF-LIKE -->
+<!-- in THEOREM-LIKE, detached/standalone, in solutions                                  -->
+<!-- INNER-PROOF-FILTER only used where heading levels are controlled                    -->
+<!-- SOLUTION-PROOF-FILTER used extensively to control LaTeX environments/macros/styling -->
+<!-- standalone/detached is just everything else (in division, or paragraphs, or...)     -->
+<!ENTITY INNER-PROOF-FILTER "(&PROOF-FILTER;) and (parent::theorem or parent::corollary or parent::lemma or parent::algorithm or parent::proposition or parent::claim or parent::fact or parent::identity)">
+<!ENTITY SOLUTION-PROOF-FILTER "(&PROOF-FILTER;) and (ancestor::hint or ancestor::answer or ancestor::solution)">
+<!-- a mathematical statement, but never with a proof -->
+<!ENTITY AXIOM-LIKE "axiom|conjecture|principle|heuristic|hypothesis|assumption">
+<!ENTITY AXIOM-FILTER "self::axiom or self::conjecture or self::principle or self::heuristic or self::hypothesis or self::assumption">
+<!-- narrative, set off for structure, reference -->
+<!ENTITY REMARK-LIKE "remark|convention|note|observation|warning|insight">
+<!ENTITY REMARK-FILTER "self::remark or self::convention or self::note or self::observation or self::warning or self::insight">
+<!-- about computations or technology -->
+<!ENTITY COMPUTATION-LIKE "computation|technology|data">
+<!ENTITY COMPUTATION-FILTER "self::computation or self::technology or self::data">
+<!-- incidental, skippable, lightweight -->
+<!ENTITY ASIDE-LIKE "aside|biographical|historical">
+<!ENTITY ASIDE-FILTER "self::aside or self::biographical or self::historical">
+<!-- blocks, or statement + solution -->
+<!ENTITY EXAMPLE-LIKE "example|question|problem">
+<!ENTITY EXAMPLE-FILTER "self::example or self::question or self::problem">
+<!-- blocks, or statement + solution -->
+<!-- save off lab, laboratory, experiment for science -->
+<!-- NB: update comprehensive list in the Guide with any additions -->
+<!ENTITY PROJECT-LIKE "project|activity|exploration|investigation">
+<!ENTITY PROJECT-FILTER "self::project or self::activity or self::exploration or self::investigation">
+<!-- blocks with meta-information in lists -->
+<!-- TODO: add in "standards", "goals"     -->
+<!-- NB: update comprehensive list in the Guide with any additions -->
+<!ENTITY GOAL-LIKE "objectives|outcomes">
+<!ENTITY GOAL-FILTER "self::objectives or self::outcomes">
+<!-- Open = research question/problem/conjecture -->
+<!ENTITY OPENPROBLEM-LIKE "openproblem|openquestion|openconjecture">
+<!ENTITY OPENPROBLEM-FILTER "self::openproblem or self::openquestion or self::openconjecture">
+<!-- displays with captions -->
+<!ENTITY FIGURE-LIKE "figure|table|listing|list">
+<!ENTITY FIGURE-FILTER "self::figure or self::table or self::listing or self::list">
+<!-- Composite filters for the numbering "serial-stamp" pass.  The      -->
+<!-- "fundamental" blocks always share the overall blocks counter; a    -->
+<!-- "top" figure-like is a captioned display that earns a number (a    -->
+<!-- panel inside a captioned side-by-side earns a letter instead).     -->
+<!ENTITY FUNDAMENTAL-BLOCK-FILTER "(&DEFINITION-FILTER;) or (&THEOREM-FILTER;) or (&AXIOM-FILTER;) or (&REMARK-FILTER;) or (&COMPUTATION-FILTER;) or (&EXAMPLE-FILTER;)">
+<!ENTITY TOP-FIGURE-FILTER "(&FIGURE-FILTER;) and not(parent::sidebyside/parent::figure or parent::sidebyside/parent::sbsgroup/parent::figure)">
+<!-- appendages of examples, exercises, tasks -->
+<!ENTITY SOLUTION-LIKE "hint|answer|solution">
+<!ENTITY SOLUTION-FILTER "self::hint or self::answer or self::solution">
+<!-- appendages of OPENPROBLEM-LIKE -->
+<!ENTITY DISCUSSION-LIKE "context|discussion|opinion|status|suggestion">
+<!ENTITY DISCUSSION-FILTER "self::context or self::discussion or self::opinion or self::status or self::suggestion">
+<!-- When context is an inline "exercise", then this condition is      -->
+<!-- true. We are positive, so as new locations of "exercise"          -->
+<!-- are added, then this need not change                              -->
+<!-- Typical use: self::exercise and boolean(&INLINE-EXERCISE-FILTER;) -->
+<!ENTITY INLINE-EXERCISE-FILTER "parent::article|parent::paragraphs|parent::chapter|parent::appendix|parent::section|parent::subsection|parent::subsubsection|parent::handout">