@pretextbook/pretext-html 0.3.0 → 0.4.0

package/dist/index.js

@@ -1,4 +1,4 @@
-import { d as r, f as i, a as t, i as a, r as l, m as o, s as m, b as n, x as d } from "./cli-CzoinNle.js";
+import { d as r, f as i, a as t, i as a, r as l, m as o, s as m, b as n, x as d } from "./cli-Cp6C0sif.js";
 import { describeAsset as c, missingAssetPlaceholder as f, missingAssetSvg as g, rewriteAssetUrls as A } from "./assets.js";
 import { PREVIEW_THEME_MESSAGE as h, injectThemeBridge as S, isPreviewTheme as b, previewThemeMessage as u, themeBridgeScript as x } from "./theme.js";
 export {

package/dist/publication.d.ts

@@ -8,12 +8,20 @@
  * variables can only come from a publication file — there is no stringparam
  * for `portable` — so we rewrite the user's publication file (or synthesize a
  * minimal one) and serve it through the fetch shim as a virtual file.
+ *
+ * That rewrite is also how an embedder's default HTML theme gets in
+ * (`<html><css theme="..."/></html>`): same reason, no stringparam for it
+ * either, short of `debug.html.theme-name`.
  */
 /**
  * Return publication-file XML with `<html><platform portable="yes"/></html>`
  * forced, preserving everything else from `publicationXml` when given.
+ *
+ * `cssTheme`, when given, supplies `<html><css theme="..."/></html>` for
+ * projects that do not choose an HTML theme themselves; see
+ * `RenderOptions.cssTheme`. A blank value is ignored.
  */
-export declare function forcePortablePublication(publicationXml?: string): string;
+export declare function forcePortablePublication(publicationXml?: string, cssTheme?: string): string;
 /**
  * Where a project's images live, as declared by
  * `<source><directories external generated/></source>`.

package/dist/renderer.d.ts

@@ -35,6 +35,26 @@ export interface RenderOptions {
      * `<html><platform portable="yes"/></html>`, which the preview forces.
      */
     publicationPath?: string;
+    /**
+     * PreTeXt HTML theme to fall back on, inserted into the publication file
+     * used for the build as `<html><css theme="..."/></html>`.
+     *
+     * A default, not an override: it applies only when the project's own
+     * publication file names no theme (neither `@theme` nor the deprecated
+     * `@style`/`@shell`), so a project that has chosen one keeps it. Blank is
+     * ignored, and with no publication file at all it themes the synthesized
+     * minimal one.
+     *
+     * Portable builds load `theme-<name>.min.css` from the CDN, so an
+     * unrecognised name renders an unstyled page. The themes the vendored
+     * stylesheets know are default-modern (PreTeXt's own default), denver,
+     * tacoma, salem, greeley and boulder; `custom` additionally needs a locally
+     * compiled stylesheet, which this renderer cannot produce.
+     *
+     * Distinct from {@link RenderOptions.theme}, which is the light/dark mode
+     * *within* whichever css theme is in force.
+     */
+    cssTheme?: string;
     /** Additional XSLT string parameters, passed as strings (quoted for you). */
     stringParams?: Record<string, string>;
     /** Directory of PreTeXt XSL stylesheets. Defaults to the vendored copy. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pretextbook/pretext-html",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Convert PreTeXt documents to HTML in pure JavaScript using the official PreTeXt XSLT stylesheets via libxslt-wasm. No Python or PreTeXt installation required.",
   "author": "Oscar Levin",
   "license": "MIT",