@fruggr/zendesk-mcp-server 3.7.0 → 3.8.0

package/README.md

@@ -14,11 +14,14 @@ puts Zendesk inside your AI assistant, for **both sides of the conversation**.
 translates articles while keeping the languages in sync; and handles Support
 tickets end to end, comments, triage and image attachments included.
 
-**For your customers**: it opens the same door the Help Center's "Submit a
-request" form does. They pick the kind of request, get walked through the
-questions that form actually asks, attach a screenshot, then follow the
-ticket — read the replies, answer back, close it when it's resolved. See
-[End-user mode](#end-user-mode).
+**For your customers**: the Help Center's "Submit a request" form, in plain
+language: pick the request, answer its questions, follow the replies, close it.
+See [End-user mode](#end-user-mode).
+
+**For your Zendesk admins**: teach the assistant how *your* team works, with
+house tone, lexicon, procedures and ready-made workflows, from a dedicated
+back-office, with no redeploy. See
+[Context and customizations](#context-and-customizations).
 
 It all happens in plain language, without switching apps.
 
@@ -49,6 +52,8 @@ then calls the right tools on your behalf.
 - Draft and maintain knowledge-base articles. You can write a new one, or revise
   a large one a single section at a time, so the whole HTML body never has to
   round-trip through the model.
+- Follow your team's playbook. Instructions, prompts and skills written by your
+  admins reach every user's assistant, whatever MCP client they use.
 - Submit and follow a request as a customer, not an agent. Choose between the
   kinds of request the vendor offers, answer only the questions that form asks,
   and then track it: what was replied, what you replied, and whether it's done.
@@ -81,11 +86,16 @@ differently.
   into namespace proxies, or collapse everything into a single unified tool. You
   can also filter by namespace or down to read-only operations, so each context
   loads only the surface it needs (see [Tool surface](#tool-surface)).
-- Two deployment shapes, same auth story. Run it on your laptop as a stdio MCP
-  server, or deploy it as a private remote MCP server reached over HTTP, with one
-  Zendesk session per request and each client carrying its own user's token.
-- A lean stack: the official MCP TypeScript SDK (`@modelcontextprotocol/server`) plus `zod`, speaking to
-  the Zendesk Support and Help Center (Guide) APIs.
+- Your practices ship with the server. Most teams hand-distribute a skill or a
+  rules file per AI client. Here admins author instructions, prompts and skills
+  once, inside the server, behind a back-office reserved to Zendesk admins, and
+  every MCP client receives them. Skills fall back to prompts on clients that
+  don't support them yet.
+- Two deployment shapes, same auth story, on a lean stack. Run it on your laptop
+  as a stdio MCP server, or deploy it as a private remote MCP server reached over
+  HTTP, each client carrying its own user's token; underneath, the official MCP
+  TypeScript SDK plus `zod`, speaking to the Zendesk Support and Help Center
+  (Guide) APIs.
 
 Look elsewhere when:
 
@@ -316,19 +326,19 @@ A customer can do less than an agent. That's the point, not a gap:
   won't let the requester solve it, so the tool says so rather than pretending.
 - **No search across the ticket base**, no user lookups, no views, no macros.
 
-## Help Center context
+## Context and customizations
 
-Beyond tools, the server hands the LLM the structure of *your* Help Center: the
-active locales, the category → section tree with IDs, the visibility segments
-and the permission groups. With those in hand it uses real IDs instead of
-guessing or fuzzy-matching names. It all arrives through MCP-native channels,
-namely the `instructions` blob sent on `initialize` plus pull-only resources for
-the topology and for reading (or pinning) individual articles. The resources are
-fetched with the caller's own token, and clients that don't support resources
-ignore them silently.
+The assistant gets two kinds of context besides tools:
 
-What's exposed, what the promoted-article pre-listing costs in requests, and how
-to turn each piece off: **[docs/help-center-context.md](docs/help-center-context.md)**.
+- **Built in**: the structure of your Help Center (locales, the category →
+  section tree with IDs, segments, permission groups), so it uses real IDs
+  instead of guessing, fetched with the caller's own token. Details:
+  [docs/help-center-context.md](docs/help-center-context.md).
+- **Yours**: instructions, prompts and skills your Zendesk admins write from
+  `/mcp/admin`, a second connector on the same server. A guided `setup` prompt
+  walks them through it and reminds them what is already built in. Nothing is
+  stored in Zendesk, and no workflow is imposed: each team writes its own.
+  Details: [docs/customizations.md](docs/customizations.md).
 
 ## Configuration
 

package/dist/THIRD-PARTY-NOTICES.md

@@ -30,7 +30,7 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 ```
 
-## @modelcontextprotocol/core@2.3.1
+## @modelcontextprotocol/core@2.4.0
 
 License: Apache-2.0
 
@@ -253,7 +253,7 @@ CC-BY-4.0. See https://creativecommons.org/licenses/by/4.0/legalcode for
 the full license text.
 ```
 
-## @modelcontextprotocol/node@2.1.1
+## @modelcontextprotocol/node@2.1.2
 
 License: Apache-2.0
 
@@ -476,7 +476,7 @@ CC-BY-4.0. See https://creativecommons.org/licenses/by/4.0/legalcode for
 the full license text.
 ```
 
-## @modelcontextprotocol/server@2.3.1
+## @modelcontextprotocol/server@2.4.0
 
 License: Apache-2.0
 
@@ -2035,7 +2035,7 @@ TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
 SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 ```
 
-## hast-util-to-html@9.0.5
+## hast-util-to-html@9.0.6
 
 License: MIT
 
@@ -2480,7 +2480,7 @@ The above copyright notice and this permission notice shall be included in all c
 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 ```
 
-## jose@6.2.13
+## jose@6.2.14
 
 License: MIT
 

package/dist/{article-sections-CzTODYsS.js → article-sections-DA7_Jm2H.js}

@@ -48717,7 +48717,7 @@ function stringifyEntities(value, options) {
 	return core(value, Object.assign({ format: formatSmart }, options));
 }
 //#endregion
-//#region node_modules/.pnpm/hast-util-to-html@9.0.5/node_modules/hast-util-to-html/lib/handle/comment.js
+//#region node_modules/.pnpm/hast-util-to-html@9.0.6/node_modules/hast-util-to-html/lib/handle/comment.js
 /**
 * @import {Comment, Parents} from 'hast'
 * @import {State} from '../index.js'
@@ -48731,7 +48731,7 @@ const commentEntitySubset = ["<", ">"];
 * @param {Comment} node
 *   Node to handle.
 * @param {number | undefined} _1
-*   Index of `node` in `parent.
+*   Index of `node` in `parent`.
 * @param {Parents | undefined} _2
 *   Parent of `node`.
 * @param {State} state
@@ -48742,14 +48742,19 @@ const commentEntitySubset = ["<", ">"];
 function comment$3(node, _1, _2, state) {
 	return state.settings.bogusComments ? "<?" + stringifyEntities(node.value, Object.assign({}, state.settings.characterReferences, { subset: bogusCommentEntitySubset })) + ">" : "<!--" + node.value.replace(htmlCommentRegex, encode) + "-->";
 	/**
+	* Encode a dangerous character.
+	*
 	* @param {string} $0
+	*   Character.
+	* @returns {string}
+	*   Encoded character.
 	*/
 	function encode($0) {
 		return stringifyEntities($0, Object.assign({}, state.settings.characterReferences, { subset: commentEntitySubset }));
 	}
 }
 //#endregion
-//#region node_modules/.pnpm/hast-util-to-html@9.0.5/node_modules/hast-util-to-html/lib/handle/doctype.js
+//#region node_modules/.pnpm/hast-util-to-html@9.0.6/node_modules/hast-util-to-html/lib/handle/doctype.js
 /**
 * @import {Doctype, Parents} from 'hast'
 * @import {State} from '../index.js'
@@ -48760,7 +48765,7 @@ function comment$3(node, _1, _2, state) {
 * @param {Doctype} _1
 *   Node to handle.
 * @param {number | undefined} _2
-*   Index of `node` in `parent.
+*   Index of `node` in `parent`.
 * @param {Parents | undefined} _3
 *   Parent of `node`.
 * @param {State} state
@@ -48903,7 +48908,7 @@ function empty$1(value) {
 	return value.replace(re, "") === "";
 }
 //#endregion
-//#region node_modules/.pnpm/hast-util-to-html@9.0.5/node_modules/hast-util-to-html/lib/omission/util/siblings.js
+//#region node_modules/.pnpm/hast-util-to-html@9.0.6/node_modules/hast-util-to-html/lib/omission/util/siblings.js
 /**
 * @import {Parents, RootContent} from 'hast'
 */
@@ -48915,6 +48920,9 @@ const emptyChildren$1 = [];
 * Factory to check siblings in a direction.
 *
 * @param {number} increment
+*   Direction.
+* @returns {typeof sibling}
+*   Check.
 */
 function siblings(increment) {
 	return sibling;
@@ -48944,7 +48952,7 @@ function siblings(increment) {
 	}
 }
 //#endregion
-//#region node_modules/.pnpm/hast-util-to-html@9.0.5/node_modules/hast-util-to-html/lib/omission/omission.js
+//#region node_modules/.pnpm/hast-util-to-html@9.0.6/node_modules/hast-util-to-html/lib/omission/omission.js
 /**
 * @import {Element, Parents} from 'hast'
 */
@@ -48959,7 +48967,6 @@ function siblings(increment) {
 *   Parent of element.
 * @returns {boolean}
 *   Whether to omit a tag.
-*
 */
 const own$10 = {}.hasOwnProperty;
 /**
@@ -48983,7 +48990,7 @@ function omission(handlers) {
 	}
 }
 //#endregion
-//#region node_modules/.pnpm/hast-util-to-html@9.0.5/node_modules/hast-util-to-html/lib/omission/closing.js
+//#region node_modules/.pnpm/hast-util-to-html@9.0.6/node_modules/hast-util-to-html/lib/omission/closing.js
 /**
 * @import {Element, Parents} from 'hast'
 */
@@ -49070,7 +49077,7 @@ function body$1(_, index, parent) {
 */
 function p$2(_, index, parent) {
 	const next = siblingAfter(parent, index);
-	return next ? next.type === "element" && (next.tagName === "address" || next.tagName === "article" || next.tagName === "aside" || next.tagName === "blockquote" || next.tagName === "details" || next.tagName === "div" || next.tagName === "dl" || next.tagName === "fieldset" || next.tagName === "figcaption" || next.tagName === "figure" || next.tagName === "footer" || next.tagName === "form" || next.tagName === "h1" || next.tagName === "h2" || next.tagName === "h3" || next.tagName === "h4" || next.tagName === "h5" || next.tagName === "h6" || next.tagName === "header" || next.tagName === "hgroup" || next.tagName === "hr" || next.tagName === "main" || next.tagName === "menu" || next.tagName === "nav" || next.tagName === "ol" || next.tagName === "p" || next.tagName === "pre" || next.tagName === "section" || next.tagName === "table" || next.tagName === "ul") : !parent || !(parent.type === "element" && (parent.tagName === "a" || parent.tagName === "audio" || parent.tagName === "del" || parent.tagName === "ins" || parent.tagName === "map" || parent.tagName === "noscript" || parent.tagName === "video"));
+	return next ? next.type === "element" && (next.tagName === "address" || next.tagName === "article" || next.tagName === "aside" || next.tagName === "blockquote" || next.tagName === "details" || next.tagName === "div" || next.tagName === "dl" || next.tagName === "fieldset" || next.tagName === "figcaption" || next.tagName === "figure" || next.tagName === "footer" || next.tagName === "form" || next.tagName === "h1" || next.tagName === "h2" || next.tagName === "h3" || next.tagName === "h4" || next.tagName === "h5" || next.tagName === "h6" || next.tagName === "header" || next.tagName === "hgroup" || next.tagName === "hr" || next.tagName === "main" || next.tagName === "menu" || next.tagName === "nav" || next.tagName === "ol" || next.tagName === "p" || next.tagName === "pre" || next.tagName === "section" || next.tagName === "table" || next.tagName === "ul") : !parent || !(parent.type === "element" && (parent.tagName === "a" || parent.tagName === "audio" || parent.tagName === "del" || parent.tagName === "ins" || parent.tagName === "map" || parent.tagName === "noscript" || parent.tagName === "video" || parent.tagName.includes("-")));
 }
 /**
 * Whether to omit `</li>`.
@@ -49248,7 +49255,7 @@ function cells(_, index, parent) {
 	return !next || next.type === "element" && (next.tagName === "td" || next.tagName === "th");
 }
 //#endregion
-//#region node_modules/.pnpm/hast-util-to-html@9.0.5/node_modules/hast-util-to-html/lib/omission/opening.js
+//#region node_modules/.pnpm/hast-util-to-html@9.0.6/node_modules/hast-util-to-html/lib/omission/opening.js
 /**
 * @import {Element, Parents} from 'hast'
 */
@@ -49318,8 +49325,8 @@ function body(node) {
 */
 function colgroup(node, index, parent) {
 	const previous = siblingBefore(parent, index);
-	const head = siblingAfter(node, -1, true);
 	if (parent && previous && previous.type === "element" && previous.tagName === "colgroup" && closing(previous, parent.children.indexOf(previous), parent)) return false;
+	const head = siblingAfter(node, -1, true);
 	return Boolean(head && head.type === "element" && head.tagName === "col");
 }
 /**
@@ -49336,12 +49343,12 @@ function colgroup(node, index, parent) {
 */
 function tbody(node, index, parent) {
 	const previous = siblingBefore(parent, index);
-	const head = siblingAfter(node, -1);
 	if (parent && previous && previous.type === "element" && (previous.tagName === "thead" || previous.tagName === "tbody") && closing(previous, parent.children.indexOf(previous), parent)) return false;
+	const head = siblingAfter(node, -1);
 	return Boolean(head && head.type === "element" && head.tagName === "tr");
 }
 //#endregion
-//#region node_modules/.pnpm/hast-util-to-html@9.0.5/node_modules/hast-util-to-html/lib/handle/element.js
+//#region node_modules/.pnpm/hast-util-to-html@9.0.6/node_modules/hast-util-to-html/lib/handle/element.js
 /**
 * @import {Element, Parents, Properties} from 'hast'
 * @import {State} from '../index.js'
@@ -49362,12 +49369,22 @@ const constants = {
 	double: [["\"&".split(""), "\"&'`".split("")], ["\0\"&".split(""), "\0\"&'`".split("")]]
 };
 /**
+* SVG elements whose content is HTML.
+*
+* @type {ReadonlySet<string>}
+*/
+const htmlIntegrationPoints = /* @__PURE__ */ new Set([
+	"desc",
+	"foreignObject",
+	"title"
+]);
+/**
 * Serialize an element node.
 *
 * @param {Element} node
 *   Node to handle.
 * @param {number | undefined} index
-*   Index of `node` in `parent.
+*   Index of `node` in `parent`.
 * @param {Parents | undefined} parent
 *   Parent of `node`.
 * @param {State} state
@@ -49376,22 +49393,21 @@ const constants = {
 *   Serialized node.
 */
 function element$4(node, index, parent, state) {
-	const schema = state.schema;
+	const { schema } = state;
 	const omit = schema.space === "svg" ? false : state.settings.omitOptionalTags;
 	let selfClosing = schema.space === "svg" ? state.settings.closeEmptyElements : state.settings.voids.includes(node.tagName.toLowerCase());
 	/** @type {Array<string>} */
 	const parts = [];
-	/** @type {string} */
-	let last;
 	if (schema.space === "html" && node.tagName === "svg") state.schema = svg;
 	const attributes = serializeAttributes(state, node.properties);
+	if (state.schema.space === "svg" && htmlIntegrationPoints.has(node.tagName)) state.schema = html$4;
 	const content = state.all(schema.space === "html" && node.tagName === "template" ? node.content : node);
 	state.schema = schema;
 	if (content) selfClosing = false;
 	if (attributes || !omit || !opening(node, index, parent)) {
 		parts.push("<", node.tagName, attributes ? " " + attributes : "");
 		if (selfClosing && (schema.space === "svg" || state.settings.closeSelfClosing)) {
-			last = attributes.charAt(attributes.length - 1);
+			const last = attributes.charAt(attributes.length - 1);
 			if (!state.settings.tightSelfClosing || last === "/" || last && last !== "\"" && last !== "'") parts.push(" ");
 			parts.push("/");
 		}
@@ -49402,9 +49418,14 @@ function element$4(node, index, parent, state) {
 	return parts.join("");
 }
 /**
+* Serialize all attributes.
+*
 * @param {State} state
+*   Info passed around about the current state.
 * @param {Properties | null | undefined} properties
+*   Properties.
 * @returns {string}
+*   Serialized attributes.
 */
 function serializeAttributes(state, properties) {
 	/** @type {Array<string>} */
@@ -49425,18 +49446,21 @@ function serializeAttributes(state, properties) {
 	return values.join("");
 }
 /**
+* Serialize an attribute.
+*
 * @param {State} state
+*   Info passed around about the current state.
 * @param {string} key
+*   Property name.
 * @param {Properties[keyof Properties]} value
+*   Property value.
 * @returns {string}
+*   Serialized attribute.
 */
 function serializeAttribute(state, key, value) {
 	const info = find(state.schema, key);
 	const x = state.settings.allowParseErrors && state.schema.space === "html" ? 0 : 1;
 	const y = state.settings.allowDangerousCharacters ? 0 : 1;
-	let quote = state.quote;
-	/** @type {string | undefined} */
-	let result;
 	if (info.overloadedBoolean && (value === info.attribute || value === "")) value = true;
 	else if ((info.boolean || info.overloadedBoolean) && (typeof value !== "string" || value === info.attribute || value === "")) value = Boolean(value);
 	if (value === null || value === void 0 || value === false || typeof value === "number" && Number.isNaN(value)) return "";
@@ -49444,11 +49468,14 @@ function serializeAttribute(state, key, value) {
 	if (value === true) return name;
 	value = Array.isArray(value) ? (info.commaSeparated ? stringify$1 : stringify)(value, { padLeft: !state.settings.tightCommaSeparatedLists }) : String(value);
 	if (state.settings.collapseEmptyAttributes && !value) return name;
+	/** @type {string | undefined} */
+	let result;
 	if (state.settings.preferUnquoted) result = stringifyEntities(value, Object.assign({}, state.settings.characterReferences, {
 		attribute: true,
 		subset: constants.unquoted[x][y]
 	}));
 	if (result !== value) {
+		let { quote } = state;
 		if (state.settings.quoteSmart && ccount(value, quote) > ccount(value, state.alternative)) quote = state.alternative;
 		result = quote + stringifyEntities(value, Object.assign({}, state.settings.characterReferences, {
 			subset: (quote === "'" ? constants.single : constants.double)[x][y],
@@ -49458,7 +49485,7 @@ function serializeAttribute(state, key, value) {
 	return name + (result ? "=" + result : result);
 }
 //#endregion
-//#region node_modules/.pnpm/hast-util-to-html@9.0.5/node_modules/hast-util-to-html/lib/handle/text.js
+//#region node_modules/.pnpm/hast-util-to-html@9.0.6/node_modules/hast-util-to-html/lib/handle/text.js
 /**
 * @import {Parents, Text} from 'hast'
 * @import {Raw} from 'mdast-util-to-hast'
@@ -49471,7 +49498,7 @@ const textEntitySubset = ["<", "&"];
 * @param {Raw | Text} node
 *   Node to handle.
 * @param {number | undefined} _
-*   Index of `node` in `parent.
+*   Index of `node` in `parent`.
 * @param {Parents | undefined} parent
 *   Parent of `node`.
 * @param {State} state
@@ -49483,7 +49510,7 @@ function text$8(node, _, parent, state) {
 	return parent && parent.type === "element" && (parent.tagName === "script" || parent.tagName === "style") ? node.value : stringifyEntities(node.value, Object.assign({}, state.settings.characterReferences, { subset: textEntitySubset }));
 }
 //#endregion
-//#region node_modules/.pnpm/hast-util-to-html@9.0.5/node_modules/hast-util-to-html/lib/handle/raw.js
+//#region node_modules/.pnpm/hast-util-to-html@9.0.6/node_modules/hast-util-to-html/lib/handle/raw.js
 /**
 * @import {Parents} from 'hast'
 * @import {Raw} from 'mdast-util-to-hast'
@@ -49495,7 +49522,7 @@ function text$8(node, _, parent, state) {
 * @param {Raw} node
 *   Node to handle.
 * @param {number | undefined} index
-*   Index of `node` in `parent.
+*   Index of `node` in `parent`.
 * @param {Parents | undefined} parent
 *   Parent of `node`.
 * @param {State} state
@@ -49507,7 +49534,7 @@ function raw$1(node, index, parent, state) {
 	return state.settings.allowDangerousHtml ? node.value : text$8(node, index, parent, state);
 }
 //#endregion
-//#region node_modules/.pnpm/hast-util-to-html@9.0.5/node_modules/hast-util-to-html/lib/handle/root.js
+//#region node_modules/.pnpm/hast-util-to-html@9.0.6/node_modules/hast-util-to-html/lib/handle/root.js
 /**
 * @import {Parents, Root} from 'hast'
 * @import {State} from '../index.js'
@@ -49518,7 +49545,7 @@ function raw$1(node, index, parent, state) {
 * @param {Root} node
 *   Node to handle.
 * @param {number | undefined} _1
-*   Index of `node` in `parent.
+*   Index of `node` in `parent`.
 * @param {Parents | undefined} _2
 *   Parent of `node`.
 * @param {State} state
@@ -49530,7 +49557,7 @@ function root$5(node, _1, _2, state) {
 	return state.all(node);
 }
 //#endregion
-//#region node_modules/.pnpm/hast-util-to-html@9.0.5/node_modules/hast-util-to-html/lib/handle/index.js
+//#region node_modules/.pnpm/hast-util-to-html@9.0.6/node_modules/hast-util-to-html/lib/handle/index.js
 /**
 * @import {Nodes, Parents} from 'hast'
 * @import {State} from '../index.js'
@@ -49565,7 +49592,7 @@ function invalid$1(node) {
 * Fail when a node with an unknown type is found in the tree.
 *
 * @param {unknown} node_
-*  Unknown node.
+*   Unknown node.
 * @returns {never}
 *   Never.
 */
@@ -49573,7 +49600,7 @@ function unknown$2(node_) {
 	throw new Error("Cannot compile unknown node `" + node_.type + "`");
 }
 //#endregion
-//#region node_modules/.pnpm/hast-util-to-html@9.0.5/node_modules/hast-util-to-html/lib/index.js
+//#region node_modules/.pnpm/hast-util-to-html@9.0.6/node_modules/hast-util-to-html/lib/index.js
 /**
 * @import {Nodes, Parents, RootContent} from 'hast'
 * @import {Schema} from 'property-information'
@@ -49604,7 +49631,7 @@ function unknown$2(node_) {
 *   > 👉 **Note**: intentionally creates parse errors in markup (how parse
 *   > errors are handled is well defined, so this works but isn’t pretty).
 * @property {boolean | null | undefined} [bogusComments=false]
-*   Use “bogus comments” instead of comments to save byes: `<?charlie>`
+*   Use “bogus comments” instead of comments to save bytes: `<?charlie>`
 *   instead of `<!--charlie-->` (default: `false`).
 *
 *   > 👉 **Note**: intentionally creates parse errors in markup (how parse
@@ -49655,13 +49682,16 @@ function unknown$2(node_) {
 * @property {Space | null | undefined} [space='html']
 *   When an `<svg>` element is found in the HTML space, this package already
 *   automatically switches to and from the SVG space when entering and exiting
-*   it (default: `'html'`).
+*   it, and goes to HTML inside `desc`, `foreignObject`, and `title`
+*   (default: `'html'`).
 *
 *   > 👉 **Note**: hast is not XML.
 *   > It supports SVG as embedded in HTML.
 *   > It does not support the features available in XML.
 *   > Passing SVG might break but fragments of modern SVG should be fine.
 *   > Use [`xast`][xast] if you need to support SVG as XML.
+*
+*    [xast]: https://github.com/syntax-tree/xast
 * @property {boolean | null | undefined} [tightAttributes=false]
 *   Join attributes together, without whitespace, if possible: get
 *   `class="a b"title="c d"` instead of `class="a b" title="c d"` to save
@@ -49741,8 +49771,8 @@ const emptyChildren = [];
 function toHtml(tree, options) {
 	const options_ = options || emptyOptions$7;
 	const quote = options_.quote || "\"";
-	const alternative = quote === "\"" ? "'" : "\"";
 	if (quote !== "\"" && quote !== "'") throw new Error("Invalid quote `" + quote + "`, expected `'` or `\"`");
+	const alternative = quote === "\"" ? "'" : "\"";
 	return {
 		one: one$4,
 		all: all$7,
@@ -49781,7 +49811,7 @@ function toHtml(tree, options) {
 * @param {Nodes} node
 *   Node to handle.
 * @param {number | undefined} index
-*   Index of `node` in `parent.
+*   Index of `node` in `parent`.
 * @param {Parents | undefined} parent
 *   Parent of `node`.
 * @returns {string}
@@ -49798,6 +49828,7 @@ function one$4(node, index, parent) {
 * @param {Parents | undefined} parent
 *   Parent whose children to serialize.
 * @returns {string}
+*   Serialized children.
 */
 function all$7(parent) {
 	/** @type {Array<string>} */