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

@pretextbook/pretext-html 0.1.0 → 0.1.1

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 (111) hide show

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

package/README.md CHANGED Viewed

@@ -71,12 +71,51 @@ const { html } = await renderHtml({
   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).
+- `theme: "dark" | "light" | "system"` makes the preview follow the embedding
+  app's light/dark theme (see [Theme control](#theme-control)).
+### Theme control
+A rendered page can already switch between light and dark — pretext-core.js
+exposes `window.setDarkMode(isDark)` — but on its own it only decides which to
+use from `localStorage` and `prefers-color-scheme`. Neither reflects an
+embedder's surroundings ("VS Code is in a dark editor theme", "pretext.plus is
+in dark mode"). The `theme` render option lets the app drive it instead:
+```js
+import { renderHtml } from "@pretextbook/pretext-html";
+// dependency-free subpath — no WASM renderer pulled in:
+import { previewThemeMessage } from "@pretextbook/pretext-html/theme";
+const { html } = await renderHtml({
+  sourcePath: "source/main.ptx",
+  theme: "dark", // initial theme baked in (no light-then-dark flash)
+});
+// Later, when the host theme changes, post an update — no re-render needed:
+iframe.contentWindow.postMessage(previewThemeMessage("light"), "*");
+// (VS Code webview: webview.postMessage(previewThemeMessage("light")))
+// (inline render:  window.postMessage(previewThemeMessage("light"), "*"))
+```
+When `theme` is set, the renderer injects a small script into the page `<head>`
+that (1) applies the initial theme and (2) listens for
+`postMessage({ type: "pretext-html:set-theme", theme })` from the embedder and
+re-applies live. `"system"` follows `prefers-color-scheme`. Omit `theme`
+entirely and the output is byte-identical to a plain render — the page keeps
+its native `localStorage`/`prefers-color-scheme` behaviour. The
+`@pretextbook/pretext-html/theme` subpath exports the protocol
+(`PreviewTheme`, `PREVIEW_THEME_MESSAGE`, `previewThemeMessage`,
+`isPreviewTheme`) with no dependency on the renderer, so a host can import just
+the message helper.
 ## 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;
+- **Node ≥ 24** launched with **`--experimental-wasm-jspi`** (WebAssembly
+  stack switching). Node 22 does **not** work despite accepting the flag: its
+  V8 (12.4) has only the older Suspender-era JSPI and never exposes the
+  `WebAssembly.Suspending` API this package needs. 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

package/assets/preview-html.xsl CHANGED Viewed

@@ -1,230 +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>
+<?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 CHANGED Viewed

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

package/assets/xsl/README.md CHANGED Viewed

File without changes