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

@pretextbook/pretext-html 0.1.0 → 0.2.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 (106) hide show

package/README.md +104 -4
package/assets/preview-html.xsl +230 -230
package/assets/upstream.json +7 -7
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/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/extract-math.xsl +256 -256
package/assets/xsl/support/package-math.xsl +141 -141
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/null.xml +3 -3
package/assets/xsl/tests/pretext-text-utilities-test.xsl +333 -333
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/assets/xsl-bundle.json +1 -0
package/dist/{cli-C6tfAVvi.js → cli-B2LiKunq.js} +268 -233
package/dist/cli.js +1 -1
package/dist/host.browser.d.ts +29 -0
package/dist/host.d.ts +41 -0
package/dist/index.browser.d.ts +29 -0
package/dist/index.browser.js +650 -0
package/dist/index.d.ts +5 -0
package/dist/index.js +16 -8
package/dist/internal/posix-path.d.ts +59 -0
package/dist/mounts.d.ts +18 -0
package/dist/renderer.d.ts +14 -1
package/dist/theme.d.ts +68 -0
package/dist/theme.js +93 -0
package/package.json +22 -4

package/README.md CHANGED Viewed

@@ -71,12 +71,103 @@ 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)).
+### API (browser)
+The same renderer runs in a browser — no server, no Python. Bundlers pick it up
+through the `browser` export condition automatically; there is nothing to
+configure.
+```js
+import { renderHtml, isJspiAvailable } from "@pretextbook/pretext-html";
+if (!isJspiAvailable()) {
+  // No WebAssembly JSPI in this engine — fall back to a server-side build.
+}
+const { html } = await renderHtml({
+  sourcePath: "/source/main.ptx", // a *virtual* path: no filesystem is read
+  sourceContent: editorText, // required in the browser
+  projectDir: "/source",
+  fragment: true, // rendering one division on its own
+});
+```
+Differences from the Node API, all of them consequences of there being no
+filesystem:
+- **`sourceContent` is required.** `sourcePath` still anchors relative
+  `xi:include`s and the output's URLs, but nothing is read from it.
+- **`xi:include`s are not resolved from disk.** Pre-merge them, or pass the
+  already-merged document as `sourceContent`. An unresolvable include uses its
+  `<xi:fallback>` if it has one, and otherwise throws.
+- **`publicationPath` / `docinfoSourcePath` need absolute URLs**, since those
+  are the only readable locations. Prefer `docinfo` (a string) over
+  `docinfoSourcePath`.
+- **Stylesheets are fetched from jsDelivr**, version-pinned to the installed
+  package, so no build configuration is needed. To self-host them, copy this
+  package's `assets/` directory somewhere your app serves and call
+  `setAssetsBase("/pretext-assets")` before the first render. (Under Node the
+  equivalent is `PRETEXT_HTML_ASSETS`, or the same `setAssetsBase`.)
+- **A cold render costs two requests**, not ~32: `assets/xsl-bundle.json` packs
+  the whole stylesheet closure (13 stylesheets plus the 17 locale files
+  `pretext-common.xsl` eagerly loads) into one file. It is purely an
+  optimisation — if it is missing, each file is fetched individually and the
+  render still succeeds. It is recorded from a real render by
+  `npm run build-xsl-bundle`, which runs as part of `npm run build`.
+Typical timings, measured on a single-division fragment: **~400ms cold**
+(stylesheet compile plus asset fetch, paid once per session and then cached)
+and **~90ms warm**. That is what makes preview-on-save feel instant.
+`setMountReader()` is the escape hatch if neither delivery mode fits — it lets
+you serve the stylesheets from an in-memory map, a zip, or a webview resource
+URI.
+### 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
@@ -110,13 +201,22 @@ const { html } = await renderHtml({
    (libxml2's own XInclude pass cannot suspend in the current WASM build).
    Supports nested includes, `parse="text"`, and `xi:fallback`; `xpointer` is
    not supported.
+5. **Platform seam** — `src/host.ts` holds everything that touches the outside
+   world: read a file under a mount, read a caller-named file, locate
+   `assets/`. Under Node those are filesystem calls; in the browser build
+   (`src/host.browser.ts`, swapped in by `vite.config.mts`) they are `fetch`es.
+   The browser build also substitutes a posix-only `node:path`
+   (`src/internal/posix-path.ts`), which is sound because no path this package
+   computes ever reaches a real filesystem — with `FILESYSTEM=0` they are all
+   virtual, ending up as mount keys or `.ptx.invalid` URL segments. The result
+   has no `node:` imports at all; rollup fails the build if one survives.
 ## 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  |
+| JSPI required (flagged on Node)                | Loader fetches resources mid-transform via JSPI | Feature-detect with `isJspiAvailable()`; engines without it need a fallback |
 | 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            |

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"
+}