@pretextbook/web-editor 0.5.0 → 0.5.1

package/dist/sectionUtils.d.ts

@@ -313,15 +313,23 @@ export declare function assembleProjectSource(divisions: Division[], rootXmlId:
  * `<section xml:id="...">...</section>`) into a standalone PreTeXt fragment
  * document suitable for a build-server preview of just that division.
  *
- * Unlike {@link assembleProjectSource}, this never expands `<plus:* ref="..."/>`
- * placeholders — they are left as-is for the build server to handle when
- * rendering a fragment preview.
+ * This function itself never expands `<plus:* ref="..."/>` placeholders —
+ * the real build server has no notion of that placeholder syntax, so callers
+ * must resolve them first (e.g. via {@link assembleProjectSource}) before
+ * passing `divisionXml` in. Passing unresolved refs produces invalid PreTeXt
+ * and a build failure.
  *
  * `divisionType` determines the minimal wrapper needed around `divisionXml`:
  * root types (`book`/`article`/`slideshow`) need none, `chapter`/`part` are
  * wrapped in a bare `<book>`, and everything else in a bare `<article>`.
+ * The PreTeXt schema requires `<book>`/`<article>` to have a `<title>` as
+ * their first child, so a wrapper built here uses `wrapperTitle` for that —
+ * without it the build server's schema validation rejects the document,
+ * produces no output, and 500s.
  * `docinfo` (the full `<docinfo>...</docinfo>` element, or `""`) is inserted
  * as a sibling of the root element inside `<pretext>`, matching real PreTeXt
  * document shape.
+ *
+ * We need to add `label="preview"` (or really any label) since if this isn't present the build server won't know what file to return.
  */
-export declare function wrapDivisionForPreview(divisionType: DivisionType, divisionXml: string, docinfo: string): string;
+export declare function wrapDivisionForPreview(divisionType: DivisionType, divisionXml: string, docinfo: string, wrapperTitle: string): string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pretextbook/web-editor",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "private": false,
   "description": "A web-based editor for PreTeXt documents, with simple preview functionality",
   "keywords": [