punctilio 5.4.8 → 5.4.9

package/dist/markdown.js

@@ -3,10 +3,10 @@ import remarkParse from "remark-parse";
 import remarkGfm from "remark-gfm";
 import remarkStringify from "remark-stringify";
 import QuickLRU from "quick-lru";
+import { MARKDOWN_OPTION_KEYS } from "./sink-option-keys.js";
 import { remarkPunctilio } from "./remark.js";
-import { MARKDOWN_ONLY_OPTION_KEYS, MARKDOWN_OPTION_KEYS } from "./sink-option-keys.js";
-import { assertKnownOptionKeys, stableStringify } from "./utils.js";
-export { MARKDOWN_ONLY_OPTION_KEYS, MARKDOWN_OPTION_KEYS };
+import { assertKnownOptionKeys, stableStringify, transformPreservingBom } from "./utils.js";
+export { MARKDOWN_ONLY_OPTION_KEYS, MARKDOWN_OPTION_KEYS } from "./sink-option-keys.js";
 function createProcessor(options) {
     const { emphasisMarker, strongMarker, bulletMarker, ruleMarker, ...punctilioOptions } = options;
     return unified()
@@ -35,8 +35,40 @@ const processorCache = new QuickLRU({
 export function clearProcessorCache() {
     processorCache.clear();
 }
-export async function transformMarkdown(input, options = {}) {
-    assertKnownOptionKeys(options, MARKDOWN_OPTION_KEYS, "transformMarkdown");
+// Opening fence → fences that may close the block (YAML accepts `...` too).
+// A Map, so a first line like `constructor` cannot resolve to an inherited
+// Object.prototype member.
+const FRONTMATTER_CLOSING_FENCES = new Map([
+    ["---", ["---", "..."]],
+    ["+++", ["+++"]],
+]);
+/**
+ * Length of the YAML (`---`) or TOML (`+++`) front matter block at the very
+ * start of `input`, through its closing fence line and newline. 0 when the
+ * input has no terminated front matter block.
+ */
+function frontmatterLength(input) {
+    let lineStart = 0;
+    let closingFences;
+    while (lineStart < input.length) {
+        const newlineIndex = input.indexOf("\n", lineStart);
+        const lineEnd = newlineIndex === -1 ? input.length : newlineIndex + 1;
+        const fence = input.slice(lineStart, lineEnd).trimEnd();
+        if (closingFences === undefined) {
+            closingFences = FRONTMATTER_CLOSING_FENCES.get(fence);
+            if (closingFences === undefined)
+                return 0;
+        }
+        else if (closingFences.includes(fence)) {
+            return lineEnd;
+        }
+        lineStart = lineEnd;
+    }
+    return 0;
+}
+/** Matches blank lines that separate front matter from the document body. */
+const LEADING_BLANK_LINES_RE = /^(?:[ \t]*\r?\n)*/;
+async function processMarkdown(input, options) {
     const optionsKey = stableStringify(options);
     let processor = processorCache.get(optionsKey);
     if (!processor) {
@@ -46,4 +78,19 @@ export async function transformMarkdown(input, options = {}) {
     const result = await processor.process(input);
     return String(result);
 }
+export async function transformMarkdown(input, options = {}) {
+    assertKnownOptionKeys(options, MARKDOWN_OPTION_KEYS, "transformMarkdown");
+    return transformPreservingBom(input, (text) => transformWithFrontmatter(text, options));
+}
+async function transformWithFrontmatter(input, options) {
+    const frontmatterEnd = frontmatterLength(input);
+    if (frontmatterEnd === 0)
+        return processMarkdown(input, options);
+    // Front matter is data (YAML/TOML), not prose; remark would parse it as a
+    // thematic break plus a heading and rewrite it.
+    const body = input.slice(frontmatterEnd);
+    const blankLines = LEADING_BLANK_LINES_RE.exec(body)[0];
+    const transformedBody = await processMarkdown(body.slice(blankLines.length), options);
+    return input.slice(0, frontmatterEnd) + blankLines + transformedBody;
+}
 //# sourceMappingURL=markdown.js.map

package/dist/markdown.js.map

@@ -1 +1 @@
-{"version":3,"file":"markdown.js","sourceRoot":"","sources":["../src/markdown.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,WAAW,MAAM,cAAc,CAAA;AACtC,OAAO,SAAS,MAAM,YAAY,CAAA;AAClC,OAAO,eAAe,MAAM,kBAAkB,CAAA;AAC9C,OAAO,QAAQ,MAAM,WAAW,CAAA;AAEhC,OAAO,EAAE,eAAe,EAA+B,MAAM,aAAa,CAAA;AAC1E,OAAO,EAAE,yBAAyB,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AACvF,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AA2BnE,OAAO,EAAE,yBAAyB,EAAE,oBAAoB,EAAE,CAAA;AAE1D,SAAS,eAAe,CAAC,OAAwB;IAC/C,MAAM,EACJ,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,GAAG,gBAAgB,EACpB,GAAG,OAAO,CAAA;IAEX,OAAO,OAAO,EAAE;SACb,GAAG,CAAC,WAAW,CAAC;SAChB,GAAG,CAAC,SAAS,CAAC;SACd,GAAG,CAAC,eAAe,EAAE,gBAAgB,CAAC;SACtC,GAAG,CAAC,eAAe,EAAE;QACpB,QAAQ,EAAE,cAAc,IAAI,GAAG;QAC/B,MAAM,EAAE,YAAY,IAAI,GAAG;QAC3B,MAAM,EAAE,YAAY,IAAI,GAAG;QAC3B,IAAI,EAAE,UAAU,IAAI,GAAG;QACvB,kEAAkE;QAClE,uDAAuD;QACvD,GAAG,CAAC,UAAU,KAAK,GAAG,IAAI,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChF,sEAAsE;QACtE,sEAAsE;QACtE,6CAA6C;QAC7C,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC;KACtD,CAAC,CAAA;AACN,CAAC;AAED,MAAM,wBAAwB,GAAG,CAAC,CAAA;AAElC,MAAM,cAAc,GAAG,IAAI,QAAQ,CAA6C;IAC9E,OAAO,EAAE,wBAAwB;CAClC,CAAC,CAAA;AAEF,gBAAgB;AAChB,MAAM,UAAU,mBAAmB;IACjC,cAAc,CAAC,KAAK,EAAE,CAAA;AACxB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,KAAa,EACb,UAA2B,EAAE;IAE7B,qBAAqB,CAAC,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,CAAC,CAAA;IAEzE,MAAM,UAAU,GAAG,eAAe,CAAC,OAAO,CAAC,CAAA;IAE3C,IAAI,SAAS,GAAG,cAAc,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IAC9C,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,SAAS,GAAG,eAAe,CAAC,OAAO,CAAC,CAAA;QACpC,cAAc,CAAC,GAAG,CAAC,UAAU,EAAE,SAAS,CAAC,CAAA;IAC3C,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;IAC7C,OAAO,MAAM,CAAC,MAAM,CAAC,CAAA;AACvB,CAAC"}
+{"version":3,"file":"markdown.js","sourceRoot":"","sources":["../src/markdown.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,WAAW,MAAM,cAAc,CAAA;AACtC,OAAO,SAAS,MAAM,YAAY,CAAA;AAClC,OAAO,eAAe,MAAM,kBAAkB,CAAA;AAC9C,OAAO,QAAQ,MAAM,WAAW,CAAA;AAEhC,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AAC5D,OAAO,EAAE,eAAe,EAA+B,MAAM,aAAa,CAAA;AAC1E,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AAE3F,OAAO,EAAE,yBAAyB,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AA2BvF,SAAS,eAAe,CAAC,OAAwB;IAC/C,MAAM,EACJ,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,GAAG,gBAAgB,EACpB,GAAG,OAAO,CAAA;IAEX,OAAO,OAAO,EAAE;SACb,GAAG,CAAC,WAAW,CAAC;SAChB,GAAG,CAAC,SAAS,CAAC;SACd,GAAG,CAAC,eAAe,EAAE,gBAAgB,CAAC;SACtC,GAAG,CAAC,eAAe,EAAE;QACpB,QAAQ,EAAE,cAAc,IAAI,GAAG;QAC/B,MAAM,EAAE,YAAY,IAAI,GAAG;QAC3B,MAAM,EAAE,YAAY,IAAI,GAAG;QAC3B,IAAI,EAAE,UAAU,IAAI,GAAG;QACvB,kEAAkE;QAClE,uDAAuD;QACvD,GAAG,CAAC,UAAU,KAAK,GAAG,IAAI,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChF,sEAAsE;QACtE,sEAAsE;QACtE,6CAA6C;QAC7C,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC;KACtD,CAAC,CAAA;AACN,CAAC;AAED,MAAM,wBAAwB,GAAG,CAAC,CAAA;AAElC,MAAM,cAAc,GAAG,IAAI,QAAQ,CAA6C;IAC9E,OAAO,EAAE,wBAAwB;CAClC,CAAC,CAAA;AAEF,gBAAgB;AAChB,MAAM,UAAU,mBAAmB;IACjC,cAAc,CAAC,KAAK,EAAE,CAAA;AACxB,CAAC;AAED,4EAA4E;AAC5E,2EAA2E;AAC3E,2BAA2B;AAC3B,MAAM,0BAA0B,GAA2C,IAAI,GAAG,CAAC;IACjF,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACvB,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC;CACjB,CAAC,CAAA;AAEF;;;;GAIG;AACH,SAAS,iBAAiB,CAAC,KAAa;IACtC,IAAI,SAAS,GAAG,CAAC,CAAA;IACjB,IAAI,aAA4C,CAAA;IAChD,OAAO,SAAS,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;QAChC,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,CAAA;QACnD,MAAM,OAAO,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,GAAG,CAAC,CAAA;QACrE,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,OAAO,EAAE,CAAA;QACvD,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;YAChC,aAAa,GAAG,0BAA0B,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;YACrD,IAAI,aAAa,KAAK,SAAS;gBAAE,OAAO,CAAC,CAAA;QAC3C,CAAC;aAAM,IAAI,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACzC,OAAO,OAAO,CAAA;QAChB,CAAC;QACD,SAAS,GAAG,OAAO,CAAA;IACrB,CAAC;IACD,OAAO,CAAC,CAAA;AACV,CAAC;AAED,6EAA6E;AAC7E,MAAM,sBAAsB,GAAG,mBAAmB,CAAA;AAElD,KAAK,UAAU,eAAe,CAAC,KAAa,EAAE,OAAwB;IACpE,MAAM,UAAU,GAAG,eAAe,CAAC,OAAO,CAAC,CAAA;IAE3C,IAAI,SAAS,GAAG,cAAc,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IAC9C,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,SAAS,GAAG,eAAe,CAAC,OAAO,CAAC,CAAA;QACpC,cAAc,CAAC,GAAG,CAAC,UAAU,EAAE,SAAS,CAAC,CAAA;IAC3C,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;IAC7C,OAAO,MAAM,CAAC,MAAM,CAAC,CAAA;AACvB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,KAAa,EACb,UAA2B,EAAE;IAE7B,qBAAqB,CAAC,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,CAAC,CAAA;IACzE,OAAO,sBAAsB,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,wBAAwB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAA;AACzF,CAAC;AAED,KAAK,UAAU,wBAAwB,CAAC,KAAa,EAAE,OAAwB;IAC7E,MAAM,cAAc,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAA;IAC/C,IAAI,cAAc,KAAK,CAAC;QAAE,OAAO,eAAe,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;IAEhE,0EAA0E;IAC1E,gDAAgD;IAChD,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,cAAc,CAAC,CAAA;IACxC,MAAM,UAAU,GAAG,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAE,CAAC,CAAC,CAAC,CAAA;IACxD,MAAM,eAAe,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAA;IACrF,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,GAAG,UAAU,GAAG,eAAe,CAAA;AACtE,CAAC"}

package/dist/peer-dependencies.d.ts

@@ -0,0 +1,21 @@
+import type { HtmlOptions } from "./html.js";
+import type { MarkdownOptions } from "./markdown.js";
+export type SinkType = "md" | "html";
+/** Imports a bare package specifier; injectable so tests can simulate an uninstalled peer. */
+export type PeerImporter = (packageName: string) => Promise<unknown>;
+export interface SinkTransformers {
+    md: (input: string, options: MarkdownOptions) => Promise<string>;
+    html: (input: string, options: HtmlOptions) => Promise<string>;
+}
+/** The optional peer dependencies each sink needs at runtime. */
+export declare const SINK_PEER_DEPENDENCIES: Readonly<Record<SinkType, readonly string[]>>;
+/** Thrown when an optional peer dependency needed for the requested file type is not installed. */
+export declare class MissingPeerDependencyError extends Error {
+}
+/**
+ * Lazily loads the transform for `type`, so only the peers for the file type
+ * being processed need to be installed.
+ * @throws MissingPeerDependencyError naming every absent peer and the install command.
+ */
+export declare function loadSinkTransform<T extends SinkType>(type: T, importPeer?: PeerImporter): Promise<SinkTransformers[T]>;
+//# sourceMappingURL=peer-dependencies.d.ts.map

package/dist/peer-dependencies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"peer-dependencies.d.ts","sourceRoot":"","sources":["../src/peer-dependencies.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAC5C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAEpD,MAAM,MAAM,QAAQ,GAAG,IAAI,GAAG,MAAM,CAAA;AAEpC,8FAA8F;AAC9F,MAAM,MAAM,YAAY,GAAG,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;AAEpE,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IAChE,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;CAC/D;AAED,iEAAiE;AACjE,eAAO,MAAM,sBAAsB,EAAE,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC,CAGhF,CAAA;AAED,mGAAmG;AACnG,qBAAa,0BAA2B,SAAQ,KAAK;CAAG;AAWxD;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,SAAS,QAAQ,EACxD,IAAI,EAAE,CAAC,EACP,UAAU,GAAE,YAA4B,GACvC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAkB9B"}

package/dist/peer-dependencies.js

@@ -0,0 +1,40 @@
+/** The optional peer dependencies each sink needs at runtime. */
+export const SINK_PEER_DEPENDENCIES = {
+    md: ["unified", "remark-parse", "remark-gfm", "remark-stringify"],
+    html: ["unified", "rehype-parse", "rehype-stringify"],
+};
+/** Thrown when an optional peer dependency needed for the requested file type is not installed. */
+export class MissingPeerDependencyError extends Error {
+}
+const MODULE_NOT_FOUND_CODES = new Set(["ERR_MODULE_NOT_FOUND", "MODULE_NOT_FOUND"]);
+function isMissingPackage(err, packageName) {
+    const { code, message } = err;
+    return MODULE_NOT_FOUND_CODES.has(code ?? "") && message.includes(`'${packageName}'`);
+}
+const importPackage = (packageName) => import(packageName);
+/**
+ * Lazily loads the transform for `type`, so only the peers for the file type
+ * being processed need to be installed.
+ * @throws MissingPeerDependencyError naming every absent peer and the install command.
+ */
+export async function loadSinkTransform(type, importPeer = importPackage) {
+    const missing = [];
+    for (const packageName of SINK_PEER_DEPENDENCIES[type]) {
+        try {
+            await importPeer(packageName);
+        }
+        catch (err) {
+            if (!isMissingPackage(err, packageName))
+                throw err;
+            missing.push(packageName);
+        }
+    }
+    if (missing.length > 0) {
+        throw new MissingPeerDependencyError(`Processing ${type === "md" ? "Markdown" : "HTML"} files requires ${missing.join(", ")}, which ` +
+            `${missing.length === 1 ? "is" : "are"} not installed. Install with: npm install ${missing.join(" ")}`);
+    }
+    if (type === "md")
+        return (await import("./markdown.js")).transformMarkdown;
+    return (await import("./html.js")).transformHtml;
+}
+//# sourceMappingURL=peer-dependencies.js.map

package/dist/peer-dependencies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"peer-dependencies.js","sourceRoot":"","sources":["../src/peer-dependencies.ts"],"names":[],"mappings":"AAaA,iEAAiE;AACjE,MAAM,CAAC,MAAM,sBAAsB,GAAkD;IACnF,EAAE,EAAE,CAAC,SAAS,EAAE,cAAc,EAAE,YAAY,EAAE,kBAAkB,CAAC;IACjE,IAAI,EAAE,CAAC,SAAS,EAAE,cAAc,EAAE,kBAAkB,CAAC;CACtD,CAAA;AAED,mGAAmG;AACnG,MAAM,OAAO,0BAA2B,SAAQ,KAAK;CAAG;AAExD,MAAM,sBAAsB,GAAG,IAAI,GAAG,CAAC,CAAC,sBAAsB,EAAE,kBAAkB,CAAC,CAAC,CAAA;AAEpF,SAAS,gBAAgB,CAAC,GAAY,EAAE,WAAmB;IACzD,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,GAA4B,CAAA;IACtD,OAAO,sBAAsB,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,WAAW,GAAG,CAAC,CAAA;AACvF,CAAC;AAED,MAAM,aAAa,GAAiB,CAAC,WAAW,EAAE,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,CAAA;AAExE;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,IAAO,EACP,aAA2B,aAAa;IAExC,MAAM,OAAO,GAAa,EAAE,CAAA;IAC5B,KAAK,MAAM,WAAW,IAAI,sBAAsB,CAAC,IAAI,CAAC,EAAE,CAAC;QACvD,IAAI,CAAC;YACH,MAAM,UAAU,CAAC,WAAW,CAAC,CAAA;QAC/B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,gBAAgB,CAAC,GAAG,EAAE,WAAW,CAAC;gBAAE,MAAM,GAAG,CAAA;YAClD,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;QAC3B,CAAC;IACH,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,0BAA0B,CAClC,cAAc,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,mBAAmB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU;YAChG,GAAG,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,6CAA6C,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CACvG,CAAA;IACH,CAAC;IACD,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,CAAC,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,iBAAwC,CAAA;IAClG,OAAO,CAAC,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,aAAoC,CAAA;AACzE,CAAC"}

package/dist/prettier-plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prettier-plugin.d.ts","sourceRoot":"","sources":["../src/prettier-plugin.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAU,MAAM,EAAE,MAAM,UAAU,CAAA;AAkC9C,QAAA,MAAM,MAAM,EAAE,MAab,CAAA;AAED,eAAe,MAAM,CAAA"}
+{"version":3,"file":"prettier-plugin.d.ts","sourceRoot":"","sources":["../src/prettier-plugin.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAU,MAAM,EAAE,MAAM,UAAU,CAAA;AAiC9C,QAAA,MAAM,MAAM,EAAE,MAab,CAAA;AAED,eAAe,MAAM,CAAA"}

package/dist/prettier-plugin.js

@@ -1,8 +1,7 @@
 import { dirname } from "node:path";
 import * as prettierMarkdown from "prettier/plugins/markdown";
 import { cosmiconfig } from "cosmiconfig";
-import { HTML_ONLY_OPTION_KEYS } from "./html.js";
-import { MARKDOWN_ONLY_OPTION_KEYS } from "./markdown.js";
+import { HTML_ONLY_OPTION_KEYS, MARKDOWN_ONLY_OPTION_KEYS } from "./sink-option-keys.js";
 import { remarkPunctilio } from "./remark.js";
 import { omitKeys } from "./utils.js";
 const upstreamMarkdown = prettierMarkdown.parsers.markdown;

package/dist/prettier-plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"prettier-plugin.js","sourceRoot":"","sources":["../src/prettier-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC,OAAO,KAAK,gBAAgB,MAAM,2BAA2B,CAAA;AAG7D,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAEzC,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAA;AACjD,OAAO,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAA;AACzD,OAAO,EAAE,eAAe,EAA+B,MAAM,aAAa,CAAA;AAC1E,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAErC,MAAM,gBAAgB,GAAG,gBAAgB,CAAC,OAAO,CAAC,QAAwB,CAAA;AAC1E,MAAM,QAAQ,GAAG,WAAW,CAAC,WAAW,CAAC,CAAA;AAEzC,0EAA0E;AAC1E,4EAA4E;AAC5E,gEAAgE;AAChE,MAAM,wBAAwB,GAAsB;IAClD,GAAG,yBAAyB;IAC5B,GAAG,qBAAqB;CACzB,CAAA;AAED,KAAK,UAAU,mBAAmB,CAAC,UAAkB;IACnD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,CAAA;IAChD,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,OAAO;QAAE,OAAO,EAAE,CAAA;IACxC,OAAO,QAAQ,CAAC,MAAM,CAAC,MAAgC,EAAE,wBAAwB,CAAC,CAAA;AACpF,CAAC;AAED,KAAK,UAAU,kBAAkB,CAAC,IAA4B,EAAE,GAAS;IACvE,uEAAuE;IACvE,uEAAuE;IACvE,4DAA4D;IAC5D,MAAM,WAAW,GAAG,eAAe,CAAC,IAAI,CAAyC,CAAA;IACjF,MAAM,WAAW,CAAC,GAAG,CAAC,CAAA;AACxB,CAAC;AAED,MAAM,MAAM,GAAW;IACrB,OAAO,EAAE;QACP,QAAQ,EAAE;YACR,GAAG,gBAAgB;YACnB,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO;gBACvB,MAAM,GAAG,GAAG,MAAM,gBAAgB,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;gBACvD,MAAM,UAAU,GAAG,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAA;gBACnG,MAAM,IAAI,GAAG,MAAM,mBAAmB,CAAC,UAAU,CAAC,CAAA;gBAClD,MAAM,kBAAkB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;gBACnC,OAAO,GAAG,CAAA;YACZ,CAAC;SACF;KACF;CACF,CAAA;AAED,eAAe,MAAM,CAAA"}
+{"version":3,"file":"prettier-plugin.js","sourceRoot":"","sources":["../src/prettier-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC,OAAO,KAAK,gBAAgB,MAAM,2BAA2B,CAAA;AAG7D,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAEzC,OAAO,EAAE,qBAAqB,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAA;AACxF,OAAO,EAAE,eAAe,EAA+B,MAAM,aAAa,CAAA;AAC1E,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAErC,MAAM,gBAAgB,GAAG,gBAAgB,CAAC,OAAO,CAAC,QAAwB,CAAA;AAC1E,MAAM,QAAQ,GAAG,WAAW,CAAC,WAAW,CAAC,CAAA;AAEzC,0EAA0E;AAC1E,4EAA4E;AAC5E,gEAAgE;AAChE,MAAM,wBAAwB,GAAsB;IAClD,GAAG,yBAAyB;IAC5B,GAAG,qBAAqB;CACzB,CAAA;AAED,KAAK,UAAU,mBAAmB,CAAC,UAAkB;IACnD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,CAAA;IAChD,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,OAAO;QAAE,OAAO,EAAE,CAAA;IACxC,OAAO,QAAQ,CAAC,MAAM,CAAC,MAAgC,EAAE,wBAAwB,CAAC,CAAA;AACpF,CAAC;AAED,KAAK,UAAU,kBAAkB,CAAC,IAA4B,EAAE,GAAS;IACvE,uEAAuE;IACvE,uEAAuE;IACvE,4DAA4D;IAC5D,MAAM,WAAW,GAAG,eAAe,CAAC,IAAI,CAAyC,CAAA;IACjF,MAAM,WAAW,CAAC,GAAG,CAAC,CAAA;AACxB,CAAC;AAED,MAAM,MAAM,GAAW;IACrB,OAAO,EAAE;QACP,QAAQ,EAAE;YACR,GAAG,gBAAgB;YACnB,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO;gBACvB,MAAM,GAAG,GAAG,MAAM,gBAAgB,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;gBACvD,MAAM,UAAU,GAAG,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAA;gBACnG,MAAM,IAAI,GAAG,MAAM,mBAAmB,CAAC,UAAU,CAAC,CAAA;gBAClD,MAAM,kBAAkB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;gBACnC,OAAO,GAAG,CAAA;YACZ,CAAC;SACF;KACF;CACF,CAAA;AAED,eAAe,MAAM,CAAA"}

package/dist/utils.d.ts

@@ -7,6 +7,11 @@
 export declare function formatErrorString(content: string, label: string): string;
 /** Throws if `options` contains a key not present in `validKeys`. @internal */
 export declare function assertKnownOptionKeys(options: object, validKeys: readonly string[], context: string): void;
+/**
+ * Runs `transform` on `input` without its leading BOM, which would otherwise
+ * be parsed as content, and restores the BOM on the result. @internal
+ */
+export declare function transformPreservingBom(input: string, transform: (inputWithoutBom: string) => Promise<string>): Promise<string>;
 /** Returns a copy of `obj` without the listed keys. @internal */
 export declare function omitKeys<T extends object>(obj: T, keys: readonly string[]): Partial<T>;
 /** Returns a copy of `obj` with `undefined`-valued keys removed. @internal */

package/dist/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAkBxE;AAED,+EAA+E;AAC/E,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,OAAO,EAAE,MAAM,GACd,IAAI,CAQN;AAED,iEAAiE;AACjE,wBAAgB,QAAQ,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAMtF;AAED,8EAA8E;AAC9E,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAMpE;AAED,wFAAwF;AACxF,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAMnD"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAkBxE;AAED,+EAA+E;AAC/E,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,SAAS,MAAM,EAAE,EAC5B,OAAO,EAAE,MAAM,GACd,IAAI,CAQN;AAID;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,CAAC,eAAe,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,GACtD,OAAO,CAAC,MAAM,CAAC,CAGjB;AAED,iEAAiE;AACjE,wBAAgB,QAAQ,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAMtF;AAED,8EAA8E;AAC9E,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAMpE;AAED,wFAAwF;AACxF,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAMnD"}

package/dist/utils.js

@@ -29,6 +29,16 @@ export function assertKnownOptionKeys(options, validKeys, context) {
         }
     }
 }
+const BYTE_ORDER_MARK = "\uFEFF";
+/**
+ * Runs `transform` on `input` without its leading BOM, which would otherwise
+ * be parsed as content, and restores the BOM on the result. @internal
+ */
+export async function transformPreservingBom(input, transform) {
+    if (!input.startsWith(BYTE_ORDER_MARK))
+        return transform(input);
+    return BYTE_ORDER_MARK + (await transform(input.slice(BYTE_ORDER_MARK.length)));
+}
 /** Returns a copy of `obj` without the listed keys. @internal */
 export function omitKeys(obj, keys) {
     const result = {};

package/dist/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "punctilio",
-  "version": "5.4.8",
+  "version": "5.4.9",
   "description": "Smart typography transformations: curly quotes, em-dashes, en-dashes, and more",
   "type": "module",
   "sideEffects": false,
@@ -150,6 +150,7 @@
   "dependencies": {
     "cosmiconfig": "9.0.1",
     "ignore": "7.0.5",
+    "parse5": "7.3.0",
     "quick-lru": "7.3.0",
     "tinyglobby": "0.2.16",
     "unist-util-visit-parents": "6.0.2"

package/src/cli.ts

@@ -2,7 +2,7 @@
 
 import { createHash } from "node:crypto"
 import { existsSync, mkdirSync, readFileSync, realpathSync, writeFileSync } from "node:fs"
-import { readFile, rename, writeFile } from "node:fs/promises"
+import { chmod, readFile, realpath, rename, rm, stat, writeFile } from "node:fs/promises"
 import { dirname, extname, isAbsolute, join, relative, resolve } from "node:path"
 import { fileURLToPath } from "node:url"
 import { parseArgs } from "node:util"
@@ -11,9 +11,10 @@ import { cosmiconfig } from "cosmiconfig"
 import ignore, { type Ignore } from "ignore"
 import { glob } from "tinyglobby"
 
+import { HTML_ONLY_OPTION_KEYS, MARKDOWN_ONLY_OPTION_KEYS } from "./sink-option-keys.js"
 import type { MarkdownOptions } from "./markdown.js"
 import type { HtmlOptions } from "./html.js"
-import { HTML_ONLY_OPTION_KEYS, HTML_OPTION_KEYS, MARKDOWN_ONLY_OPTION_KEYS, MARKDOWN_OPTION_KEYS } from "./sink-option-keys.js"
+import { loadSinkTransform, MissingPeerDependencyError, type PeerImporter } from "./peer-dependencies.js"
 import { PUNCTUATION_STYLES, type PunctuationStyle } from "./quotes.js"
 import { DASH_STYLES, type DashStyle } from "./dashes.js"
 import { assertKnownOptionKeys, omitKeys, stableStringify } from "./utils.js"
@@ -25,6 +26,8 @@ interface CliIO {
   stdin: AsyncIterable<string | Buffer>
   stdout: NodeJS.WritableStream
   stderr: NodeJS.WritableStream
+  /** Overrides how optional peer dependencies are imported; tests use it to simulate one being absent. */
+  importPeer?: PeerImporter
 }
 
 class UsageError extends Error {}
@@ -133,7 +136,7 @@ Options:
   --rule-marker <char>        markdown thematic break character (choices: ${RULE_MARKERS.join(", ")})
   --skip-tag <tag>            HTML tag whose contents are left alone (repeatable)
   --skip-class <class>        HTML class name whose elements are skipped (repeatable)
-  --no-fragment               parse input as a full HTML document
+  --no-fragment               always parse HTML as a full document (default: a full document is detected from a leading <!doctype> or <html>)
   -h, --help                  display help for command
 `
 
@@ -230,11 +233,74 @@ function inferFileType(path: string, override?: FileType): FileType {
   )
 }
 
+interface ConfigValueRule {
+  expected: string
+  isValid: (value: unknown) => boolean
+}
+
+const BOOLEAN_RULE: ConfigValueRule = {
+  expected: "a boolean",
+  isValid: (value) => typeof value === "boolean",
+}
+const STRING_ARRAY_RULE: ConfigValueRule = {
+  expected: "an array of strings",
+  isValid: (value) => Array.isArray(value) && value.every((item) => typeof item === "string"),
+}
+const FUNCTION_RULE: ConfigValueRule = {
+  expected: "a function",
+  isValid: (value) => typeof value === "function",
+}
+
+function oneOfRule(choices: readonly string[]): ConfigValueRule {
+  return {
+    expected: `one of ${choices.join(", ")}`,
+    isValid: (value) => typeof value === "string" && choices.includes(value),
+  }
+}
+
+// `satisfies` makes the compiler flag any option key that lacks a rule.
+const CONFIG_VALUE_RULES = {
+  symbols: BOOLEAN_RULE,
+  collapseSpaces: BOOLEAN_RULE,
+  includeArrows: BOOLEAN_RULE,
+  fractions: BOOLEAN_RULE,
+  degrees: BOOLEAN_RULE,
+  superscript: BOOLEAN_RULE,
+  ligatures: BOOLEAN_RULE,
+  nbsp: BOOLEAN_RULE,
+  fragment: BOOLEAN_RULE,
+  transformAllElements: BOOLEAN_RULE,
+  punctuationStyle: oneOfRule(PUNCTUATION_STYLES),
+  dashStyle: oneOfRule(DASH_STYLES),
+  emphasisMarker: oneOfRule(EMPHASIS_MARKERS),
+  strongMarker: oneOfRule(EMPHASIS_MARKERS),
+  bulletMarker: oneOfRule(BULLET_MARKERS),
+  ruleMarker: oneOfRule(RULE_MARKERS),
+  skipTags: STRING_ARRAY_RULE,
+  skipClasses: STRING_ARRAY_RULE,
+  shouldSkipText: FUNCTION_RULE,
+} as const satisfies Record<keyof CliOptions, ConfigValueRule>
+
 // A config file may legitimately mix markdown-only and HTML-only keys for use
 // across file types; transformContent strips the keys the sink doesn't accept.
-const CLI_CONFIG_KEYS: readonly string[] = [
-  ...new Set([...MARKDOWN_OPTION_KEYS, ...HTML_OPTION_KEYS]),
-]
+const CLI_CONFIG_KEYS: readonly string[] = Object.keys(CONFIG_VALUE_RULES)
+
+// Keys are checked first, so every key present has a rule.
+function assertValidConfig(config: unknown, source: string): asserts config is CliOptions {
+  if (typeof config !== "object" || config === null || Array.isArray(config)) {
+    throw new UsageError(`${source} must contain an object of options.`)
+  }
+  assertKnownOptionKeys(config, CLI_CONFIG_KEYS, source)
+  for (const [key, value] of Object.entries(config)) {
+    if (value === undefined) continue
+    const rule: ConfigValueRule = CONFIG_VALUE_RULES[key as keyof CliOptions]
+    if (!rule.isValid(value)) {
+      throw new UsageError(
+        `Invalid value for "${key}" in ${source}: expected ${rule.expected}, got ${JSON.stringify(value)}.`,
+      )
+    }
+  }
+}
 
 // Config keys must match library option names (punctuationStyle, skipTags, …),
 // not the kebab-cased CLI flag names.
@@ -248,11 +314,11 @@ async function loadConfig(
   const result = configPath ? await explorer.load(configPath) : await explorer.search(cwd)
   if (!result || result.isEmpty) return {}
   try {
-    assertKnownOptionKeys(result.config as object, CLI_CONFIG_KEYS, `config file ${result.filepath}`)
+    assertValidConfig(result.config, `config file ${result.filepath}`)
   } catch (err) {
-    throw new UsageError((err as Error).message)
+    throw err instanceof UsageError ? err : new UsageError((err as Error).message)
   }
-  return result.config as CliOptions
+  return result.config
 }
 
 function loadIgnore(cwd: string, ignorePath: string | undefined): Ignore {
@@ -273,9 +339,20 @@ function isLiteralPath(pattern: string, cwd: string): boolean {
   return !hasGlobMetacharacters(pattern) || existsSync(resolve(cwd, pattern))
 }
 
-// Literal positionals pass through untouched so they error loudly if missing and
-// bypass ignore rules (naming a file explicitly is an intent to format it).
-// Ignore rules and the zero-match warning apply only to glob-expanded paths.
+// Dependency and VCS trees are never project sources; glob expansion skips them.
+const DEFAULT_GLOB_IGNORES = ["**/node_modules/**", "**/.git/**"]
+
+function isIgnored(file: string, cwd: string, ig: Ignore): boolean {
+  const rel = relative(cwd, file)
+  return !rel.startsWith("..") && ig.ignores(rel)
+}
+
+// Literal positionals pass through to the read step so a missing file errors
+// loudly. Ignore rules apply to literals and glob expansions alike, because
+// tools like pre-commit pass every staged file by name. Each glob is expanded
+// on its own, so one that matches nothing is a usage error even when another
+// glob matches; one whose matches are all ignored only warns. Negated globs
+// (`!pattern`) exclude from every other glob rather than matching on their own.
 async function discoverFiles(
   patterns: string[],
   cwd: string,
@@ -284,17 +361,33 @@ async function discoverFiles(
 ): Promise<string[]> {
   const literals = patterns.filter((p) => isLiteralPath(p, cwd))
   const globs = patterns.filter((p) => !isLiteralPath(p, cwd))
-  const expanded = globs.length > 0
-    ? await glob(globs, { cwd, absolute: true, onlyFiles: true })
-    : []
-  const kept = expanded.filter((file) => {
-    const rel = relative(cwd, file)
-    return rel.startsWith("..") || !ig.ignores(rel)
-  })
-  if (globs.length > 0 && kept.length === 0) {
-    stderr.write(`Warning: no files matched: ${globs.join(" ")}\n`)
+  const negatedGlobs = globs.filter((pattern) => pattern.startsWith("!"))
+  const positiveGlobs = globs.filter((pattern) => !pattern.startsWith("!"))
+  const expansions = await Promise.all(
+    positiveGlobs.map(async (pattern) => ({
+      pattern,
+      files: await glob([pattern, ...negatedGlobs], {
+        cwd,
+        absolute: true,
+        onlyFiles: true,
+        ignore: DEFAULT_GLOB_IGNORES,
+      }),
+    })),
+  )
+  const unmatched = positiveGlobs.length === 0
+    ? globs
+    : expansions.filter(({ files }) => files.length === 0).map(({ pattern }) => pattern)
+  if (unmatched.length > 0) {
+    throw new UsageError(`no files matched: ${unmatched.join(" ")}`)
   }
-  return [...new Set([...literals.map((p) => resolve(cwd, p)), ...kept])]
+  const keptExpanded: string[] = []
+  for (const { pattern, files } of expansions) {
+    const kept = files.filter((file) => !isIgnored(file, cwd, ig))
+    if (kept.length === 0) stderr.write(`Warning: every file matched by ${pattern} is ignored\n`)
+    keptExpanded.push(...kept)
+  }
+  const keptLiterals = literals.map((p) => resolve(cwd, p)).filter((file) => !isIgnored(file, cwd, ig))
+  return [...new Set([...keptLiterals, ...keptExpanded])]
 }
 
 interface CacheEntry {
@@ -347,10 +440,20 @@ function saveCache(location: string, cache: Cache): void {
 
 // Replace a file's contents atomically: write a sibling temp file, then rename
 // it over the target so an interrupted run can never leave a half-written file.
-async function atomicWriteFile(path: string, contents: string): Promise<void> {
-  const tmpPath = `${path}.${process.pid}.tmp`
-  await writeFile(tmpPath, contents)
-  await rename(tmpPath, path)
+// The temp file replaces the symlink's target (not the link itself) and takes
+// over the original file's permission bits; it is removed if anything fails.
+export async function atomicWriteFile(path: string, contents: string): Promise<void> {
+  const targetPath = await realpath(path)
+  const { mode } = await stat(targetPath)
+  const tmpPath = `${targetPath}.${process.pid}.tmp`
+  try {
+    await writeFile(tmpPath, contents, { mode: mode & 0o7777 })
+    await chmod(tmpPath, mode & 0o7777)
+    await rename(tmpPath, targetPath)
+  } catch (err) {
+    await rm(tmpPath, { force: true })
+    throw err
+  }
 }
 
 // cwd-relative so the cache survives directory moves and cross-machine syncs.
@@ -382,30 +485,42 @@ function buildOptions(flags: ParsedFlags): CliOptions {
 
 // The merged options may carry keys for the other sink (e.g. emphasisMarker
 // alongside skipTags from one shared config); strip the inapplicable ones so
-// each sink's strict key validation only sees keys it understands. The sinks
-// load lazily because they import the optional unified peers, which --help,
-// --version and usage errors must not need.
-async function transformContent(input: string, type: FileType, opts: CliOptions): Promise<string> {
+// each sink's strict key validation only sees keys it understands.
+async function transformContent(
+  input: string,
+  type: FileType,
+  opts: CliOptions,
+  importPeer: PeerImporter | undefined,
+): Promise<string> {
   if (type === "md") {
-    const { transformMarkdown } = await import("./markdown.js")
+    const transformMarkdown = await loadSinkTransform("md", importPeer)
     return transformMarkdown(input, omitKeys(opts, HTML_ONLY_OPTION_KEYS) as MarkdownOptions)
   }
-  const { transformHtml } = await import("./html.js")
+  const transformHtml = await loadSinkTransform("html", importPeer)
   return transformHtml(input, omitKeys(opts, MARKDOWN_ONLY_OPTION_KEYS) as HtmlOptions)
 }
 
-// The unified pipelines emit LF-only output and unconditionally append a
-// trailing newline. Restore the source's line-ending style and trailing-newline
-// presence so a CRLF file doesn't gain mixed endings (which would make --check
-// report a change forever and --write churn on every run).
+async function formatDocument(
+  original: string,
+  type: FileType,
+  opts: CliOptions,
+  importPeer: PeerImporter | undefined,
+): Promise<string> {
+  return matchLineEndings(original, await transformContent(original, type, opts, importPeer))
+}
+
+// The unified pipelines emit LF-only output. Markdown always ends in a newline;
+// a full HTML document may end without one (its final newline can be dropped
+// or sit inside <body>). Restore the source's line-ending style and
+// trailing-newline presence so a CRLF file doesn't gain mixed endings (which
+// would make --check report a change forever and --write churn on every run).
 function matchLineEndings(original: string, formatted: string): string {
-  // Normalize the LF output back to CRLF when the source used it.
-  let out = original.includes("\r\n")
+  const lineEnding = original.includes("\r\n") ? "\r\n" : "\n"
+  const out = lineEnding === "\r\n"
     ? formatted.replace(/\r\n/g, "\n").replace(/\n/g, "\r\n")
     : formatted
-  // Drop the appended trailing newline if the original had none.
-  if (!/\n$/.test(original)) out = out.replace(/\r?\n$/, "")
-  return out
+  if (!original.endsWith("\n")) return out.replace(/\r?\n$/, "")
+  return out.endsWith("\n") ? out : out + lineEnding
 }
 
 async function readStdin(stdin: AsyncIterable<string | Buffer>): Promise<string> {
@@ -443,7 +558,7 @@ export async function runCli(args: string[], io: CliIO): Promise<number> {
     }
     return await runValidated(buildFlags(values, tokens), positionals, io, version)
   } catch (err) {
-    if (err instanceof UsageError) {
+    if (err instanceof UsageError || err instanceof MissingPeerDependencyError) {
       io.stderr.write(`Error: ${err.message}\n`)
       return 2
     }
@@ -475,6 +590,10 @@ async function runValidated(
     throw new UsageError("--write and --check are mutually exclusive.")
   }
 
+  if (flags.stdinFilepath !== undefined && positionals.some((p) => p !== "-")) {
+    throw new UsageError("--stdin-filepath cannot be combined with file arguments.")
+  }
+
   if (readsStdin(positionals, flags)) {
     if (write) {
       throw new UsageError("--write cannot be used when reading from stdin.")
@@ -489,7 +608,7 @@ async function runValidated(
       throw new UsageError("Reading from stdin requires --type md|html or --stdin-filepath <path>.")
     }
     const input = await readStdin(io.stdin)
-    const output = matchLineEndings(input, await transformContent(input, type, opts))
+    const output = await formatDocument(input, type, opts, io.importPeer)
     if (check) return input === output ? 0 : 1
     io.stdout.write(output)
     return 0
@@ -502,6 +621,9 @@ async function runValidated(
 
   const ig = loadIgnore(cwd, flags.ignorePath)
   const files = await discoverFiles(positionals, cwd, ig, io.stderr)
+  // Resolve every file's type up front so an unsupported extension fails
+  // before any file has been rewritten.
+  const types = files.map((file) => inferFileType(file, flags.type))
 
   // In stdout mode every file's content must be produced, so a cache hit
   // could never skip work; only --write and --check use the cache.
@@ -512,8 +634,8 @@ async function runValidated(
   const optionsHash = cache ? hashOptions(opts) : ""
 
   let anyChanged = false
-  for (const path of files) {
-    const type = inferFileType(path, flags.type)
+  for (const [index, path] of files.entries()) {
+    const type = types[index]
     const original = await readFile(path, "utf8")
     const key = cache ? cacheKey(path, cwd) : ""
     if (cache) {
@@ -527,7 +649,7 @@ async function runValidated(
       ) continue
     }
 
-    const formatted = matchLineEndings(original, await transformContent(original, type, opts))
+    const formatted = await formatDocument(original, type, opts, io.importPeer)
     if (!write && !check) {
       io.stdout.write(formatted)
       continue
@@ -551,9 +673,19 @@ async function runValidated(
   return check && anyChanged ? 1 : 0
 }
 
+// npm links bins through symlinks, so argv[1] is the link, not the module file.
+export function isMainModule(moduleUrl: string, entryPath: string | undefined): boolean {
+  if (entryPath === undefined) return false
+  try {
+    return realpathSync(fileURLToPath(moduleUrl)) === realpathSync(entryPath)
+  } catch (err) {
+    if ((err as NodeJS.ErrnoException).code === "ENOENT") return false
+    throw err
+  }
+}
+
 /* istanbul ignore next -- entry-point bootstrap; logic is covered via runCli */
-// npm runs the bin through a node_modules/.bin symlink, so compare real paths.
-if (process.argv[1] && fileURLToPath(import.meta.url) === realpathSync(process.argv[1])) {
+if (isMainModule(import.meta.url, process.argv[1])) {
   runCli(process.argv.slice(2), {
     stdin: process.stdin,
     stdout: process.stdout,