mdat 3.6.5 → 3.6.6

package/dist/bin/cli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { S as version, a as expand, b as setLogger$1, d as templates_default, f as ensureArray, l as createReadme, r as collapse, s as strip, t as check, u as createReadmeInteractive, x as name, y as log } from "../lib-D3Fabg1J.js";
+import { S as version, a as expand, b as setLogger$1, d as templates_default, f as ensureArray, l as createReadme, r as collapse, s as strip, t as check, u as createReadmeInteractive, x as name, y as log } from "../lib-CyzOc08c.js";
 import { createLogger } from "lognow";
 import picocolors from "picocolors";
 import prettyMilliseconds from "pretty-ms";
@@ -8,7 +8,7 @@ import { write } from "to-vfile";
 import yargs from "yargs";
 import { hideBin } from "yargs/helpers";
 
-//#region src/bin/options.ts
+// src/bin/options.ts
 const nameOption = { name: {
 	alias: "n",
 	defaultDescription: "Same name as input file. Overwrites the input file.",
@@ -77,8 +77,7 @@ const compoundOption = { compound: {
 	type: "boolean"
 } };
 
-//#endregion
-//#region src/bin/cli.ts
+// src/bin/cli.ts
 const startTime = performance.now();
 const yargsInstance = yargs(hideBin(process.argv));
 try {
@@ -173,5 +172,4 @@ function getExitCode(results) {
 	return getMdatReports(results).reduce((count, report) => count + report.errors.length, 0) > 0 ? 1 : 0;
 }
 
-//#endregion
 export {  };

package/dist/lib/index.d.ts

@@ -2,7 +2,6 @@ import { ILogBasic, ILogLayer } from "lognow";
 import { Rule, Rule as Rule$1 } from "remark-mdat";
 import { MetadataContext } from "metascope";
 import { VFile } from "vfile";
-//#region src/lib/config.d.ts
 /**
  * An mdat configuration is a record of expansion rules. Keys become comment
  * keywords, values define the expansion content.
@@ -47,8 +46,6 @@ export declare function mergeConfig(a: Config, b: Config): Config;
  * Identity function providing type inference for mdat configuration files.
  */
 export declare function defineConfig(config: Config): Config;
-//#endregion
-//#region src/lib/readme/create.d.ts
 type MdatReadmeCreateOptions = {
   compound: boolean;
   expand: boolean;
@@ -68,8 +65,6 @@ declare function createReadmeInteractive(): Promise<string>;
  * @returns Path to the created readme file.
  */
 declare function createReadme(options?: Partial<MdatReadmeCreateOptions>): Promise<string>;
-//#endregion
-//#region src/lib/api.d.ts
 /**
  * Expand MDAT comments in one or more Markdown files. If no files are provided,
  * auto-finds the closest readme.md. Writing is the responsibility of the caller
@@ -141,8 +136,6 @@ export declare function checkString(markdown: string, config?: ConfigToLoad, opt
   inSync: boolean;
   result: VFile;
 }>;
-//#endregion
-//#region src/lib/context.d.ts
 /**
  * Get a bunch of platform-agnostic local metadata via metascope, exposed
  * primarily for plugin developers. Result is memoized the result.
@@ -247,8 +240,6 @@ export declare function getReadmeMetadata(): Promise<{
  * files may have changed on disk.
  */
 export declare function resetMetadataCaches(): void;
-//#endregion
-//#region src/lib/log.d.ts
 /**
  * Set the logger instance for the module. Export this for library consumers to
  * inject their own logger.
@@ -257,5 +248,4 @@ export declare function resetMetadataCaches(): void;
  *   Stream-like log target
  */
 export declare function setLogger(logger?: ILogBasic | ILogLayer<unknown>): void;
-//#endregion
 export { type Config, type ReadmeMetadata, type Rule, createReadme as create, createReadmeInteractive as createInteractive };

package/dist/lib/index.js

@@ -1,3 +1,3 @@
-import { _ as getReadmeMetadata, a as expand, b as setLogger, c as stripString, g as getContextMetadata, h as mergeConfig, i as collapseString, l as createReadme, m as loadConfig, n as checkString, o as expandString, p as defineConfig, r as collapse, s as strip, t as check, u as createReadmeInteractive, v as resetMetadataCaches } from "../lib-D3Fabg1J.js";
+import { _ as getReadmeMetadata, a as expand, b as setLogger, c as stripString, g as getContextMetadata, h as mergeConfig, i as collapseString, l as createReadme, m as loadConfig, n as checkString, o as expandString, p as defineConfig, r as collapse, s as strip, t as check, u as createReadmeInteractive, v as resetMetadataCaches } from "../lib-CyzOc08c.js";
 
 export { check, checkString, collapse, collapseString, createReadme as create, createReadmeInteractive as createInteractive, defineConfig, expand, expandString, getContextMetadata, getReadmeMetadata, loadConfig, mergeConfig, resetMetadataCaches, setLogger, strip, stripString };

package/dist/{lib-D3Fabg1J.js → lib-CyzOc08c.js}

@@ -24,12 +24,11 @@ import { Configuration } from "unified-engine";
 import untildify from "untildify";
 import { confirm, group, intro, note, outro, select } from "@clack/prompts";
 
-//#region package.json
+// package.json
 var name = "mdat";
-var version = "3.6.5";
+var version = "3.6.6";
 
-//#endregion
-//#region src/lib/deep-merge-defined.ts
+// src/lib/deep-merge-defined.ts
 const deepmerge = deepmergeCustom({ mergeArrays: false });
 function stripUndefinedDeep(object) {
 	return Array.isArray(object) ? object.map((v) => v !== null && typeof v === "object" ? stripUndefinedDeep(v) : v).filter((v) => v !== void 0) : Object.entries(object).map(([k, v]) => [k, v !== null && typeof v === "object" ? stripUndefinedDeep(v) : v]).reduce((acc, [k, v]) => v === void 0 ? acc : {
@@ -42,8 +41,7 @@ function deepMergeDefined(...objects) {
 	return deepmerge(...stripped);
 }
 
-//#endregion
-//#region src/lib/log.ts
+// src/lib/log.ts
 /**
 * The default logger instance for the library.
 */
@@ -66,8 +64,7 @@ function setLogger$2(logger) {
 	setLogger$1(getChildLogger(log, "metascope"));
 }
 
-//#endregion
-//#region src/lib/mdat-json-loader.ts
+// src/lib/mdat-json-loader.ts
 /**
 * Lets arbitrary JSON objects (like from package.json) become reasonably good
 * mdat rule sets HOWEVER cosmiconfig treats package.json as a special case and
@@ -88,8 +85,7 @@ function flattenJson(jsonObject, parentKey = "", result = {}) {
 	return result;
 }
 
-//#endregion
-//#region src/lib/context.ts
+// src/lib/context.ts
 let metascopeMetadata;
 /**
 * Get a bunch of platform-agnostic local metadata via metascope, exposed
@@ -355,8 +351,7 @@ function resetMetadataCaches() {
 	resetReadmeMetadata();
 }
 
-//#endregion
-//#region src/lib/readme/rules/badges.ts
+// src/lib/readme/rules/badges.ts
 const HOMEBREW_FORMULA_REGEX = /^(?<owner>[^\/]+)\/(?<tap>[^\/]+)\/(?<formula>[^\/]+)$/v;
 const GITHUB_REPOSITORY_REGEX$1 = /^https:\/\/github\.com\/(?<owner>[^\/]+)\/(?<repo>[^\/]+)$/v;
 const NO_NPM_PACKAGE = "no public npm package was found. Remove \"private\": true from package.json if the package is published, or list packages explicitly, e.g. badges({ npm: [\"package-name\"] })";
@@ -513,8 +508,7 @@ var badges_default = { badges: { async content(options) {
 	return badges.join("\n");
 } } };
 
-//#endregion
-//#region src/lib/readme/rules/banner.ts
+// src/lib/readme/rules/banner.ts
 var banner_default = { banner: { async content(options) {
 	const validOptions = z.object({
 		alt: z.string().optional(),
@@ -578,8 +572,7 @@ function isUrl(text, lenient = true) {
 	return !text.includes(" ") && (URL.canParse(text) || lenient && URL.canParse(`https://${text}`));
 }
 
-//#endregion
-//#region src/lib/readme/rules/code.ts
+// src/lib/readme/rules/code.ts
 const LEADING_DOT_REGEX = /^\./v;
 var code_default = { code: { async content(options) {
 	const validOptions = z.object({
@@ -592,8 +585,7 @@ var code_default = { code: { async content(options) {
 	return `\`\`\`${lang}\n${validOptions.trim ? exampleCode.trim() : exampleCode}\n\`\`\``;
 } } };
 
-//#endregion
-//#region src/lib/readme/rules/utilities/heading.ts
+// src/lib/readme/rules/utilities/heading.ts
 const MAX_HEADING_LEVEL = 6;
 /**
 * Option schema for the Markdown heading level (1-6) at which a rule emits its
@@ -628,8 +620,7 @@ function getHeadingLines(heading, level, defaultText) {
 	return [`${getHeadingPrefix(level)} ${text}`, ""];
 }
 
-//#endregion
-//#region src/lib/readme/rules/contributing.ts
+// src/lib/readme/rules/contributing.ts
 var contributing_default = { contributing: { async content(options) {
 	const validOptions = z.object({
 		heading: headingSchema,
@@ -648,8 +639,7 @@ var contributing_default = { contributing: { async content(options) {
 	].join("\n");
 } } };
 
-//#endregion
-//#region src/lib/readme/rules/utilities/version-range.ts
+// src/lib/readme/rules/utilities/version-range.ts
 const BARE_VERSION_REGEX = /^v?\d+(?:\.\d+){0,2}$/v;
 const MINIMUM_ONLY_REGEX = /^>=\s*v?(?<version>\d+(?:\.\d+){0,2})$/v;
 const LOWER_BOUND_REGEX = /(?:^|[\s\|\(^~]|>=)\s*v?(?<version>\d+(?:\.\d+){0,2})/gv;
@@ -679,8 +669,7 @@ function describeVersionRange(range) {
 	return floor === void 0 ? `\`${trimmed}\`` : `${floor} or newer (specifically \`${trimmed}\`)`;
 }
 
-//#endregion
-//#region src/lib/readme/rules/dependencies.ts
+// src/lib/readme/rules/dependencies.ts
 const PLATFORM_INFO = {
 	bun: {
 		display: "Bun",
@@ -756,8 +745,7 @@ var dependencies_default = { dependencies: { async content(options) {
 	return [...getHeadingLines(validOptions?.heading, validOptions?.headingLevel ?? 3, "Dependencies"), ...items].join("\n");
 } } };
 
-//#endregion
-//#region src/lib/readme/rules/description.ts
+// src/lib/readme/rules/description.ts
 /**
 * Simple alias for short-description
 */
@@ -767,8 +755,7 @@ var description_default = { description: { async content() {
 	return `**${description}**`;
 } } };
 
-//#endregion
-//#region src/lib/readme/rules/development-dependencies.ts
+// src/lib/readme/rules/development-dependencies.ts
 const TOOL_INFO = {
 	bun: {
 		display: "Bun",
@@ -812,15 +799,13 @@ var development_dependencies_default = { "development-dependencies": { async con
 	return [...getHeadingLines(validOptions?.heading, validOptions?.headingLevel ?? 3, "Development dependencies"), ...items].join("\n");
 } } };
 
-//#endregion
-//#region src/lib/readme/rules/dev-dependencies.ts
+// src/lib/readme/rules/dev-dependencies.ts
 /**
 * Simple alias for `development-dependencies`
 */
 var dev_dependencies_default = { "dev-dependencies": getSoleRule(development_dependencies_default) };
 
-//#endregion
-//#region src/lib/readme/rules/license.ts
+// src/lib/readme/rules/license.ts
 var license_default = { license: { async content(options) {
 	const validOptions = z.object({
 		heading: headingSchema,
@@ -833,12 +818,10 @@ var license_default = { license: { async content(options) {
 	return [...getHeadingLines(validOptions?.heading, validOptions?.headingLevel ?? 2, "License"), `[${license}](${licenseFilePath}) © ${authorDisplay}`].join("\n");
 } } };
 
-//#endregion
-//#region src/lib/readme/rules/footer.ts
+// src/lib/readme/rules/footer.ts
 var footer_default = { footer: { content: [getSoleRule(contributing_default), getSoleRule(license_default)] } };
 
-//#endregion
-//#region src/lib/readme/rules/short-description.ts
+// src/lib/readme/rules/short-description.ts
 /**
 * Simple alias for `description` rule, to match nomenclature in
 * [standard-readme](https://github.com/RichardLitt/standard-readme/blob/main/spec.md#short-description)
@@ -846,8 +829,7 @@ var footer_default = { footer: { content: [getSoleRule(contributing_default), ge
 */
 var short_description_default = { "short-description": getSoleRule(description_default) };
 
-//#endregion
-//#region src/lib/readme/rules/title.ts
+// src/lib/readme/rules/title.ts
 var title_default = { title: {
 	async content(options) {
 		const { postfix, prefix, titleCase } = z.object({
@@ -866,8 +848,7 @@ function makeTitleCase(text) {
 	return text.split(SPLIT_FOR_TITLE_CASE_REGEX).filter(Boolean).map((word) => word.charAt(0).toUpperCase() + word.slice(1)).join(" ");
 }
 
-//#endregion
-//#region src/lib/readme/rules/header.ts
+// src/lib/readme/rules/header.ts
 var header_default = { header: {
 	content: [
 		getSoleRule(title_default),
@@ -878,8 +859,7 @@ var header_default = { header: {
 	order: 2
 } };
 
-//#endregion
-//#region src/lib/readme/rules/install.ts
+// src/lib/readme/rules/install.ts
 const listFormatter = new Intl.ListFormat("en", {
 	style: "long",
 	type: "conjunction"
@@ -967,15 +947,13 @@ var install_default = { install: { async content(options) {
 	return [...headingLines, ...codeBlock$1(command)].join("\n");
 } } };
 
-//#endregion
-//#region src/lib/readme/rules/installation.ts
+// src/lib/readme/rules/installation.ts
 /**
 * Simple alias for `install`
 */
 var installation_default = { installation: getSoleRule(install_default) };
 
-//#endregion
-//#region src/lib/readme/rules/utilities/size/size-report.ts
+// src/lib/readme/rules/utilities/size/size-report.ts
 const brotliCompressAsync = promisify(brotliCompress);
 const gzipCompressAsync = promisify(gzip);
 /**
@@ -1017,8 +995,7 @@ async function createSizeReport(filePath, precision = 1) {
 	}
 }
 
-//#endregion
-//#region src/lib/readme/rules/size.ts
+// src/lib/readme/rules/size.ts
 const optionsSchema$1 = z.object({
 	compression: z.enum([
 		"none",
@@ -1040,8 +1017,7 @@ var size_default = { size: { async content(options) {
 	return getSizeForCompression(await createSizeReport(fullPath), validOptions.compression);
 } } };
 
-//#endregion
-//#region src/lib/readme/rules/size-table.ts
+// src/lib/readme/rules/size-table.ts
 const fileSchema = z.union([z.string(), z.array(z.string())]).transform((files) => Array.isArray(files) ? files : [files]);
 const optionsSchema = z.union([z.object({
 	brotli: z.boolean().optional().default(true),
@@ -1099,8 +1075,7 @@ var size_table_default = { "size-table": { async content(options) {
 	});
 } } };
 
-//#endregion
-//#region src/lib/readme/rules/skills.ts
+// src/lib/readme/rules/skills.ts
 const SKILLS_DIRECTORY = "skills";
 const SKILL_FILE_NAME = "SKILL.md";
 const GITHUB_REPOSITORY_REGEX = /^https:\/\/github\.com\/(?<slug>[^\/]+\/[^\/]+)$/v;
@@ -1207,7 +1182,11 @@ var skills_default = { skills: { async content(options) {
 		...headingLines,
 		`This project bundles ${agentSkillsLink} in its published package to help coding agents work with ${name}.`,
 		"",
-		`To sync the ${skillNoun} into your project, run ${skillsCliLink} from your project root:`,
+		`To link the ${skillNoun} into your project with [pnpm](https://pnpm.io/agent-skills) 12.11 or later, approve the package once and pnpm links its ${skillNoun} on every install:`,
+		"",
+		...codeBlock(`pnpm approve ${name}`),
+		"",
+		`With other package managers, sync the ${skillNoun} from your project root with ${skillsCliLink}:`,
 		"",
 		...codeBlock("npx skills experimental_sync"),
 		...repositoryUrl === void 0 ? [] : [
@@ -1221,8 +1200,7 @@ var skills_default = { skills: { async content(options) {
 	].join("\n");
 } } };
 
-//#endregion
-//#region src/lib/readme/rules/table-of-contents.ts
+// src/lib/readme/rules/table-of-contents.ts
 var table_of_contents_default = { "table-of-contents": {
 	async content(options, { tree }) {
 		const validOptions = z.object({
@@ -1253,15 +1231,13 @@ var table_of_contents_default = { "table-of-contents": {
 	order: 1
 } };
 
-//#endregion
-//#region src/lib/readme/rules/toc.ts
+// src/lib/readme/rules/toc.ts
 /**
 * Simple alias for table-of-contents
 */
 var toc_default = { toc: getSoleRule(table_of_contents_default) };
 
-//#endregion
-//#region src/lib/readme/rules/index.ts
+// src/lib/readme/rules/index.ts
 var rules_default = {
 	...badges_default,
 	...banner_default,
@@ -1285,8 +1261,7 @@ var rules_default = {
 	...toc_default
 };
 
-//#endregion
-//#region src/lib/config.ts
+// src/lib/config.ts
 let _configExplorer;
 let _additionalConfigExplorer;
 function getConfigExplorer() {
@@ -1368,8 +1343,7 @@ function defineConfig(config) {
 	return config;
 }
 
-//#endregion
-//#region src/lib/format.ts
+// src/lib/format.ts
 let cachedPrettier;
 const configCache = /* @__PURE__ */ new Map();
 /**
@@ -1396,8 +1370,7 @@ async function formatWithPrettier(content, filePath) {
 	});
 }
 
-//#endregion
-//#region src/lib/utilities.ts
+// src/lib/utilities.ts
 function zeroPad(n, nMax) {
 	const places = nMax === 0 ? 1 : Math.floor(Math.log10(Math.abs(nMax)) + 1);
 	return n.toString().padStart(places, "0");
@@ -1505,8 +1478,7 @@ function stripLintPlugins(config) {
 	};
 }
 
-//#endregion
-//#region src/lib/processors.ts
+// src/lib/processors.ts
 async function processFiles(files, loader, processorGetter, name, output, config) {
 	const [resolvedConfig, localRemarkConfig] = await Promise.all([loader({ additionalConfig: config }), loadAmbientRemarkConfig()]);
 	const resolvedFiles = ensureArray(files);
@@ -1553,32 +1525,25 @@ function getStripProcessor(_config, ambientRemarkConfig) {
 	});
 }
 
-//#endregion
-//#region src/lib/readme/templates/mdat-readme-compound.md?raw
+// src/lib/readme/templates/mdat-readme-compound.md?raw
 var mdat_readme_compound_default = "<!-- header -->\n\n<!-- table-of-contents -->\n\n## Overview\n\n## Getting started\n\n<!-- dependencies -->\n\n<!-- install -->\n\n## Usage\n\n### Library\n\n#### API\n\n#### Examples\n\n### CLI\n\n#### Commands\n\n#### Examples\n\n## Background\n\n### Motivation\n\n### Implementation notes\n\n### Similar projects\n\n## The future\n\n## Maintainers\n\n_List maintainer(s) for a repository, along with one way of contacting them (e.g. GitHub link or email)._\n\n## Acknowledgments\n\n_State anyone or anything that significantly helped with the development of your project. State public contact hyper-links if applicable._\n\n<!-- footer -->\n";
 
-//#endregion
-//#region src/lib/readme/templates/mdat-readme.md?raw
+// src/lib/readme/templates/mdat-readme.md?raw
 var mdat_readme_default = "<!-- title -->\n\n<!-- banner -->\n\n<!-- badges -->\n\n<!-- short-description -->\n\n<!-- table-of-contents -->\n\n## Overview\n\n## Getting started\n\n<!-- dependencies -->\n\n<!-- install -->\n\n## Usage\n\n### Library\n\n#### API\n\n#### Examples\n\n### CLI\n\n#### Commands\n\n#### Examples\n\n## Background\n\n### Motivation\n\n### Implementation notes\n\n### Similar projects\n\n## The future\n\n## Maintainers\n\n_List maintainer(s) for a repository, along with one way of contacting them (e.g. GitHub link or email)._\n\n## Acknowledgments\n\n_State anyone or anything that significantly helped with the development of your project. State public contact hyper-links if applicable._\n\n<!-- contributing -->\n\n<!-- license -->\n";
 
-//#endregion
-//#region src/lib/readme/templates/standard-readme-basic-compound.md?raw
+// src/lib/readme/templates/standard-readme-basic-compound.md?raw
 var standard_readme_basic_compound_default = "<!-- header -->\n\n<!-- install({ headingLevel: 2 }) -->\n\n## Usage\n\n```ts\n// Code block illustrating common usage.\n// Consider using the <!-- code({ file: \"path/to/example.ts\" }) --> comment as well.\n```\n\n<!-- footer -->\n";
 
-//#endregion
-//#region src/lib/readme/templates/standard-readme-basic.md?raw
+// src/lib/readme/templates/standard-readme-basic.md?raw
 var standard_readme_basic_default = "<!-- title -->\n\n<!-- short-description -->\n\n<!-- table-of-contents -->\n\n<!-- install({ headingLevel: 2 }) -->\n\n## Usage\n\n```ts\n// Code block illustrating common usage.\n// Consider using the <!-- code({ file: \"path/to/example.ts\" }) --> comment as well.\n```\n\n<!-- contributing -->\n\n<!-- license -->\n";
 
-//#endregion
-//#region src/lib/readme/templates/standard-readme-full-compound.md?raw
+// src/lib/readme/templates/standard-readme-full-compound.md?raw
 var standard_readme_full_compound_default = "<!-- header -->\n\n_Long description goes here._\n\n_No heading. Cover the main reasons for building the repository. This should describe your module in broad terms, generally in just a few paragraphs; more detail of the module's routines or methods, lengthy code examples, or other in-depth material should be given in subsequent sections._\n\n<!-- table-of-contents -->\n\n## Background\n\n_Cover motivation. Cover abstract dependencies. Cover intellectual provenance: A See Also section is also fitting._\n\n### See also\n\n<!-- install({ headingLevel: 2 }) -->\n\n<!-- dependencies -->\n\n## Usage\n\n```ts\n// Code block illustrating common usage.\n// Consider using the <!-- code({ file: \"path/to/example.ts\" }) --> comment as well.\n```\n\n```ts\n// If importable, code block indicating both import functionality and usage.\n```\n\n### CLI\n\n```ts\n// If CLI compatible, code block indicating common usage.\n```\n\n## _Extra Sections (Rename)_\n\n## Security\n\n## API\n\n_Describe exported functions and objects._\n\n- _Describe signatures, return types, callbacks, and events._\n- _Cover types covered where not obvious._\n- _Describe caveats._\n- _If using an external API generator (like go-doc, js-doc, or so on), point to an external API.md file. This can be the only item in the section, if present._\n\n## Maintainers\n\n_List maintainer(s) for a repository, along with one way of contacting them (e.g. GitHub link or email)._\n\n## Thanks\n\n_State anyone or anything that significantly helped with the development of your project. State public contact hyper-links if applicable._\n\n<!-- footer -->\n";
 
-//#endregion
-//#region src/lib/readme/templates/standard-readme-full.md?raw
+// src/lib/readme/templates/standard-readme-full.md?raw
 var standard_readme_full_default = "<!-- title -->\n\n<!-- banner -->\n\n<!-- badges -->\n\n<!-- short-description -->\n\n_Long description goes here._\n\n_No heading. Cover the main reasons for building the repository. This should describe your module in broad terms, generally in just a few paragraphs; more detail of the module's routines or methods, lengthy code examples, or other in-depth material should be given in subsequent sections._\n\n<!-- table-of-contents -->\n\n## Background\n\n_Cover motivation. Cover abstract dependencies. Cover intellectual provenance: A See Also section is also fitting._\n\n### See also\n\n<!-- install({ headingLevel: 2 }) -->\n\n<!-- dependencies -->\n\n## Usage\n\n```ts\n// Code block illustrating common usage.\n// Consider using the <!-- code({ file: \"path/to/example.ts\" }) --> comment as well.\n```\n\n```ts\n// If importable, code block indicating both import functionality and usage.\n```\n\n### CLI\n\n```ts\n// If CLI compatible, code block indicating common usage.\n```\n\n## _Extra Sections (Rename)_\n\n## Security\n\n## API\n\n_Describe exported functions and objects._\n\n- _Describe signatures, return types, callbacks, and events._\n- _Cover types covered where not obvious._\n- _Describe caveats._\n- _If using an external API generator (like go-doc, js-doc, or so on), point to an external API.md file. This can be the only item in the section, if present._\n\n## Maintainers\n\n_List maintainer(s) for a repository, along with one way of contacting them (e.g. GitHub link or email)._\n\n## Thanks\n\n_State anyone or anything that significantly helped with the development of your project. State public contact hyper-links if applicable._\n\n<!-- contributing -->\n\n<!-- license -->\n";
 
-//#endregion
-//#region src/lib/readme/templates/index.ts
+// src/lib/readme/templates/index.ts
 var templates_default = {
 	"MDAT Readme": {
 		content: {
@@ -1606,8 +1571,7 @@ var templates_default = {
 	}
 };
 
-//#endregion
-//#region src/lib/readme/create.ts
+// src/lib/readme/create.ts
 const USAGE_HEADING = "\n## Usage\n";
 const NEXT_SECTION_REGEX = /\n(?:## |<!-- (?:contributing|footer) -->)/v;
 /**
@@ -1712,8 +1676,7 @@ function getTemplateOptions() {
 	}));
 }
 
-//#endregion
-//#region src/lib/api.ts
+// src/lib/api.ts
 /**
 * Expand MDAT comments in one or more Markdown files. If no files are provided,
 * auto-finds the closest readme.md. Writing is the responsibility of the caller
@@ -1830,5 +1793,4 @@ async function formatResults(results) {
 	for (const file of results) file.value = await formatWithPrettier(file.toString(), file.path === "" ? void 0 : file.path);
 }
 
-//#endregion
 export { version as S, getReadmeMetadata as _, expand as a, setLogger$2 as b, stripString as c, templates_default as d, ensureArray as f, getContextMetadata as g, mergeConfig as h, collapseString as i, createReadme as l, loadConfig as m, checkString as n, expandString as o, defineConfig as p, collapse as r, strip as s, check as t, createReadmeInteractive as u, resetMetadataCaches as v, name as x, log as y };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mdat",
-  "version": "3.6.5",
+  "version": "3.6.6",
   "description": "CLI tool and TypeScript library to turn comments into content in Markdown files. MDAT makes it easy to generate and update dynamic boilerplate in project readmes.",
   "keywords": [
     "mdat",
@@ -41,8 +41,8 @@
     "mdat": "dist/bin/cli.js"
   },
   "files": [
-    "dist/*",
-    "skills/*"
+    "dist",
+    "skills"
   ],
   "dependencies": {
     "@clack/prompts": "^1.8.1",
@@ -58,10 +58,10 @@
     "picocolors": "^1.1.1",
     "plur": "^6.0.0",
     "pretty-bytes": "^7.2.0",
-    "pretty-ms": "^9.3.1",
+    "pretty-ms": "^10.0.0",
     "remark": "^15.0.1",
     "remark-gfm": "^4.0.1",
-    "remark-mdat": "^3.1.1",
+    "remark-mdat": "^3.1.2",
     "to-vfile": "^8.0.0",
     "type-fest": "^5.10.0",
     "unified-engine": "^11.2.2",
@@ -77,10 +77,10 @@
     "@types/node": "~24.13.6",
     "@types/unist": "^3.0.3",
     "@types/yargs": "^17.0.35",
-    "@vitest/coverage-v8": "^5.0.4",
+    "@vitest/coverage-v8": "^5.0.5",
     "brewpub": "^0.5.0",
     "bumpp": "^12.3.0",
-    "execa": "^10.1.0",
+    "execa": "^10.2.1",
     "mdat-plugin-cli-help": "^3.4.1",
     "mdat-plugin-example": "^3.0.1",
     "mdat-plugin-tldraw": "^3.0.1",
@@ -88,11 +88,11 @@
     "prettier": "^3.9.10",
     "publint": "^0.3.25",
     "shx": "^0.4.0",
-    "skills": "1.7.1",
-    "tsdown": "^0.23.1",
+    "tsdown": "^0.23.2",
+    "tslib": "^2.8.1",
     "typescript": "~6.0.3",
     "unplugin-raw": "^0.8.0",
-    "vitest": "^5.0.4"
+    "vitest": "^5.0.5"
   },
   "peerDependencies": {
     "prettier": "^3.0.0"

package/readme.md

@@ -703,7 +703,7 @@ Rules that generate inline content, like `badges`, `code`, and `size`, have no h
 
 - ##### `<!-- skills -->`
 
-  Documents the [Agent Skills](https://agentskills.io) bundled with the project and how to install them. Detects skills from `skills/<name>/SKILL.md` files, and gives each one a "Skill:" sub-heading linking to its `SKILL.md` file, followed by the first sentence of the description from its frontmatter. Publishable npm packages get instructions for syncing skills from the installed package with the `experimental_sync` command of Vercel's [skills CLI](https://github.com/vercel-labs/skills), and for installing them from the repository with `skills add`. Private packages and non-Node projects only get the repository instructions. Reports an error if no skills are found. Remember to include the `skills` directory in the `files` field of `package.json`. The optional `headingLevel` sets the Markdown heading level and defaults to `2`.
+  Documents the [Agent Skills](https://agentskills.io) bundled with the project and how to install them. Detects skills from `skills/<name>/SKILL.md` files, and gives each one a "Skill:" sub-heading linking to its `SKILL.md` file, followed by the first sentence of the description from its frontmatter. Publishable npm packages get instructions for linking skills from the installed package with pnpm's [`pnpm approve`](https://pnpm.io/agent-skills) or the `experimental_sync` command of Vercel's [skills CLI](https://github.com/vercel-labs/skills), and for installing them from the repository with `skills add`. Private packages and non-Node projects only get the repository instructions. Reports an error if no skills are found. Remember to include the `skills` directory in the `files` field of `package.json`. The optional `headingLevel` sets the Markdown heading level and defaults to `2`.
 
 #### Compound