@maizzle/framework 6.0.5 → 6.0.6

package/dist/transformers/addAttributes.js

@@ -68,7 +68,7 @@ function addAttributesDom(dom, config = {}) {
 					if (attrName === "class" && el.attribs.class) {
 						const existingClasses = el.attribs.class.split(/\s+/).filter(Boolean);
 						const newClasses = String(attrValue).split(/\s+/).filter(Boolean);
-						const mergedClasses = [...new Set([...existingClasses, ...newClasses])];
+						const mergedClasses = [.../* @__PURE__ */ new Set([...existingClasses, ...newClasses])];
 						if (mergedClasses.join(" ") !== el.attribs.class) el.attribs.class = mergedClasses.join(" ");
 					} else if (!(attrName in el.attribs)) el.attribs[attrName] = String(attrValue);
 				}

package/dist/transformers/addAttributes.js.map

@@ -1 +1 @@
-{"version":3,"file":"addAttributes.js","names":["merge"],"sources":["../../src/transformers/addAttributes.ts"],"sourcesContent":["import { defu as merge } from 'defu'\nimport type { ChildNode, Element } from 'domhandler'\nimport { parse, serialize, walk } from '../utils/ast/index.ts'\nimport type { AttributesConfig } from '../types/config.ts'\n\n/**\n * Default attributes to add to elements.\n */\nconst DEFAULT_ATTRIBUTES: Record<string, Record<string, string | boolean | number>> = {\n  table: {\n    cellpadding: 0,\n    cellspacing: 0,\n    role: 'none',\n  },\n  img: {\n    alt: '',\n  },\n}\n\n/**\n * Add attributes transformer.\n *\n * Automatically adds attributes to HTML elements based on CSS selectors.\n *\n * Default attributes (can be disabled by setting `attributes.add` to false):\n * - table: cellpadding=\"0\", cellspacing=\"0\", role=\"none\"\n * - img: alt=\"\"\n *\n * Supports tag, class, id, and attribute selectors.\n * Multiple selectors can be specified by comma-separating them.\n *\n * @param html   HTML string to transform.\n * @param config Attributes config (see {@link AttributesConfig}).\n * @returns      The transformed HTML string.\n *\n * @example\n * import { addAttributes } from '@maizzle/framework'\n *\n * const out = addAttributes('<div></div>', {\n *   add: {\n *     div: { role: 'article' },\n *     '.test': { editable: true },\n *     '#header': { 'data-id': 'main' },\n *     'div, p': { class: 'content' },\n *   },\n * })\n */\nexport function addAttributes(html: string, config: AttributesConfig = {}): string {\n  return serialize(addAttributesDom(parse(html), config))\n}\n\n/**\n * DOM-form of {@link addAttributes} used by the internal transformer pipeline.\n * Takes a parsed DOM, returns a parsed DOM — avoids redundant\n * serialize/parse round-trips when chained with other transformers.\n */\nexport function addAttributesDom(dom: ChildNode[], config: AttributesConfig = {}): ChildNode[] {\n  const addConfig = config.add\n\n  // Disabled when explicitly set to false\n  if (addConfig === false) {\n    return dom\n  }\n\n  // Deep merge user attributes on top of defaults using defu\n  const userAttributes = typeof addConfig === 'object' ? addConfig : {}\n  const attributesToAdd = merge(userAttributes, DEFAULT_ATTRIBUTES) as Record<string, false | Record<string, false | string | boolean | number>>\n\n  // Process each selector pattern\n  for (const [selectorPattern, attributes] of Object.entries(attributesToAdd)) {\n    // User opted out of this selector entirely (e.g. `table: false`)\n    if (attributes === false) continue\n    // Split by comma for multiple selectors\n    const selectors = selectorPattern.split(',').map(s => s.trim())\n\n    walk(dom, (node) => {\n      const el = node as Element\n      if (!el.name) return\n\n      // Check if element matches any selector in the pattern\n      const matches = selectors.some(selector => elementMatches(el, selector))\n\n      if (matches) {\n        // Initialize attribs if needed\n        if (!el.attribs) {\n          el.attribs = {}\n        }\n\n        for (const [attrName, attrValue] of Object.entries(attributes)) {\n          // User opted out of this specific attribute (e.g. `role: false`)\n          if (attrValue === false) continue\n          // Special handling for class - merge instead of replace\n          if (attrName === 'class' && el.attribs.class) {\n            const existingClasses = el.attribs.class.split(/\\s+/).filter(Boolean)\n            const newClasses = String(attrValue).split(/\\s+/).filter(Boolean)\n            const mergedClasses = [...new Set([...existingClasses, ...newClasses])]\n            if (mergedClasses.join(' ') !== el.attribs.class) {\n              el.attribs.class = mergedClasses.join(' ')\n            }\n          } else {\n            // Only add attribute if not already present\n            if (!(attrName in el.attribs)) {\n              el.attribs[attrName] = String(attrValue)\n            }\n          }\n        }\n      }\n    })\n  }\n\n  return dom\n}\n\n/**\n * Check if an element matches a CSS selector.\n * Supports: tag, .class, #id, [attribute], [attribute=value]\n */\nfunction elementMatches(el: Element, selector: string): boolean {\n  // Remove whitespace\n  selector = selector.trim()\n\n  // Check for attribute selector [attr] or [attr=value]\n  const attrMatch = selector.match(/^\\[([^\\]=]+)(?:=([^\\]]*))?\\]$/)\n  if (attrMatch) {\n    const [, attrName, attrValue] = attrMatch\n    if (attrValue === undefined) {\n      // Just checking if attribute exists\n      return attrName in el.attribs\n    } else {\n      // Check if attribute has specific value\n      return el.attribs?.[attrName] === attrValue\n    }\n  }\n\n  // Check for class selector .class\n  if (selector.startsWith('.')) {\n    const className = selector.slice(1)\n    const classes = el.attribs?.class?.split(/\\s+/) || []\n    return classes.includes(className)\n  }\n\n  // Check for id selector #id\n  if (selector.startsWith('#')) {\n    const id = selector.slice(1)\n    return el.attribs?.id === id\n  }\n\n  // Check for tag selector (possibly with attribute)\n  // Split tag from attribute if present, e.g., \"div[role=alert]\"\n  const tagAttrMatch = selector.match(/^([a-z][a-z0-9]*)\\[([^\\]]+)\\]$/i)\n  if (tagAttrMatch) {\n    const [, tagName, attrPart] = tagAttrMatch\n    if (el.name !== tagName) return false\n\n    // Parse attribute part: could be \"attr\" or \"attr=value\"\n    const attrEqMatch = attrPart.match(/^([^=]+)(?:=(.*))?$/)\n    if (attrEqMatch) {\n      const [, attrName, attrValue] = attrEqMatch\n      if (attrValue === undefined) {\n        return attrName in el.attribs\n      } else {\n        return el.attribs?.[attrName] === attrValue\n      }\n    }\n    return false\n  }\n\n  // Simple tag selector\n  return el.name === selector\n}\n"],"mappings":";;;;;;;;;AAQA,MAAM,qBAAgF;CACpF,OAAO;EACL,aAAa;EACb,aAAa;EACb,MAAM;CACR;CACA,KAAK,EACH,KAAK,GACP;AACF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8BA,SAAgB,cAAc,MAAc,SAA2B,CAAC,GAAW;CACjF,OAAO,UAAU,iBAAiB,MAAM,IAAI,GAAG,MAAM,CAAC;AACxD;;;;;;AAOA,SAAgB,iBAAiB,KAAkB,SAA2B,CAAC,GAAgB;CAC7F,MAAM,YAAY,OAAO;CAGzB,IAAI,cAAc,OAChB,OAAO;CAKT,MAAM,kBAAkBA,OADD,OAAO,cAAc,WAAW,YAAY,CAAC,GACtB,kBAAkB;CAGhE,KAAK,MAAM,CAAC,iBAAiB,eAAe,OAAO,QAAQ,eAAe,GAAG;EAE3E,IAAI,eAAe,OAAO;EAE1B,MAAM,YAAY,gBAAgB,MAAM,GAAG,CAAC,CAAC,KAAI,MAAK,EAAE,KAAK,CAAC;EAE9D,KAAK,MAAM,SAAS;GAClB,MAAM,KAAK;GACX,IAAI,CAAC,GAAG,MAAM;GAKd,IAFgB,UAAU,MAAK,aAAY,eAAe,IAAI,QAAQ,CAE5D,GAAG;IAEX,IAAI,CAAC,GAAG,SACN,GAAG,UAAU,CAAC;IAGhB,KAAK,MAAM,CAAC,UAAU,cAAc,OAAO,QAAQ,UAAU,GAAG;KAE9D,IAAI,cAAc,OAAO;KAEzB,IAAI,aAAa,WAAW,GAAG,QAAQ,OAAO;MAC5C,MAAM,kBAAkB,GAAG,QAAQ,MAAM,MAAM,KAAK,CAAC,CAAC,OAAO,OAAO;MACpE,MAAM,aAAa,OAAO,SAAS,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,OAAO,OAAO;MAChE,MAAM,gBAAgB,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,iBAAiB,GAAG,UAAU,CAAC,CAAC;MACtE,IAAI,cAAc,KAAK,GAAG,MAAM,GAAG,QAAQ,OACzC,GAAG,QAAQ,QAAQ,cAAc,KAAK,GAAG;KAE7C,OAEE,IAAI,EAAE,YAAY,GAAG,UACnB,GAAG,QAAQ,YAAY,OAAO,SAAS;IAG7C;GACF;EACF,CAAC;CACH;CAEA,OAAO;AACT;;;;;AAMA,SAAS,eAAe,IAAa,UAA2B;CAE9D,WAAW,SAAS,KAAK;CAGzB,MAAM,YAAY,SAAS,MAAM,+BAA+B;CAChE,IAAI,WAAW;EACb,MAAM,GAAG,UAAU,aAAa;EAChC,IAAI,cAAc,KAAA,GAEhB,OAAO,YAAY,GAAG;OAGtB,OAAO,GAAG,UAAU,cAAc;CAEtC;CAGA,IAAI,SAAS,WAAW,GAAG,GAAG;EAC5B,MAAM,YAAY,SAAS,MAAM,CAAC;EAElC,QADgB,GAAG,SAAS,OAAO,MAAM,KAAK,KAAK,CAAC,EAAA,CACrC,SAAS,SAAS;CACnC;CAGA,IAAI,SAAS,WAAW,GAAG,GAAG;EAC5B,MAAM,KAAK,SAAS,MAAM,CAAC;EAC3B,OAAO,GAAG,SAAS,OAAO;CAC5B;CAIA,MAAM,eAAe,SAAS,MAAM,iCAAiC;CACrE,IAAI,cAAc;EAChB,MAAM,GAAG,SAAS,YAAY;EAC9B,IAAI,GAAG,SAAS,SAAS,OAAO;EAGhC,MAAM,cAAc,SAAS,MAAM,qBAAqB;EACxD,IAAI,aAAa;GACf,MAAM,GAAG,UAAU,aAAa;GAChC,IAAI,cAAc,KAAA,GAChB,OAAO,YAAY,GAAG;QAEtB,OAAO,GAAG,UAAU,cAAc;EAEtC;EACA,OAAO;CACT;CAGA,OAAO,GAAG,SAAS;AACrB"}
+{"version":3,"file":"addAttributes.js","names":["merge"],"sources":["../../src/transformers/addAttributes.ts"],"sourcesContent":["import { defu as merge } from 'defu'\nimport type { ChildNode, Element } from 'domhandler'\nimport { parse, serialize, walk } from '../utils/ast/index.ts'\nimport type { AttributesConfig } from '../types/config.ts'\n\n/**\n * Default attributes to add to elements.\n */\nconst DEFAULT_ATTRIBUTES: Record<string, Record<string, string | boolean | number>> = {\n  table: {\n    cellpadding: 0,\n    cellspacing: 0,\n    role: 'none',\n  },\n  img: {\n    alt: '',\n  },\n}\n\n/**\n * Add attributes transformer.\n *\n * Automatically adds attributes to HTML elements based on CSS selectors.\n *\n * Default attributes (can be disabled by setting `attributes.add` to false):\n * - table: cellpadding=\"0\", cellspacing=\"0\", role=\"none\"\n * - img: alt=\"\"\n *\n * Supports tag, class, id, and attribute selectors.\n * Multiple selectors can be specified by comma-separating them.\n *\n * @param html   HTML string to transform.\n * @param config Attributes config (see {@link AttributesConfig}).\n * @returns      The transformed HTML string.\n *\n * @example\n * import { addAttributes } from '@maizzle/framework'\n *\n * const out = addAttributes('<div></div>', {\n *   add: {\n *     div: { role: 'article' },\n *     '.test': { editable: true },\n *     '#header': { 'data-id': 'main' },\n *     'div, p': { class: 'content' },\n *   },\n * })\n */\nexport function addAttributes(html: string, config: AttributesConfig = {}): string {\n  return serialize(addAttributesDom(parse(html), config))\n}\n\n/**\n * DOM-form of {@link addAttributes} used by the internal transformer pipeline.\n * Takes a parsed DOM, returns a parsed DOM — avoids redundant\n * serialize/parse round-trips when chained with other transformers.\n */\nexport function addAttributesDom(dom: ChildNode[], config: AttributesConfig = {}): ChildNode[] {\n  const addConfig = config.add\n\n  // Disabled when explicitly set to false\n  if (addConfig === false) {\n    return dom\n  }\n\n  // Deep merge user attributes on top of defaults using defu\n  const userAttributes = typeof addConfig === 'object' ? addConfig : {}\n  const attributesToAdd = merge(userAttributes, DEFAULT_ATTRIBUTES) as Record<string, false | Record<string, false | string | boolean | number>>\n\n  // Process each selector pattern\n  for (const [selectorPattern, attributes] of Object.entries(attributesToAdd)) {\n    // User opted out of this selector entirely (e.g. `table: false`)\n    if (attributes === false) continue\n    // Split by comma for multiple selectors\n    const selectors = selectorPattern.split(',').map(s => s.trim())\n\n    walk(dom, (node) => {\n      const el = node as Element\n      if (!el.name) return\n\n      // Check if element matches any selector in the pattern\n      const matches = selectors.some(selector => elementMatches(el, selector))\n\n      if (matches) {\n        // Initialize attribs if needed\n        if (!el.attribs) {\n          el.attribs = {}\n        }\n\n        for (const [attrName, attrValue] of Object.entries(attributes)) {\n          // User opted out of this specific attribute (e.g. `role: false`)\n          if (attrValue === false) continue\n          // Special handling for class - merge instead of replace\n          if (attrName === 'class' && el.attribs.class) {\n            const existingClasses = el.attribs.class.split(/\\s+/).filter(Boolean)\n            const newClasses = String(attrValue).split(/\\s+/).filter(Boolean)\n            const mergedClasses = [...new Set([...existingClasses, ...newClasses])]\n            if (mergedClasses.join(' ') !== el.attribs.class) {\n              el.attribs.class = mergedClasses.join(' ')\n            }\n          } else {\n            // Only add attribute if not already present\n            if (!(attrName in el.attribs)) {\n              el.attribs[attrName] = String(attrValue)\n            }\n          }\n        }\n      }\n    })\n  }\n\n  return dom\n}\n\n/**\n * Check if an element matches a CSS selector.\n * Supports: tag, .class, #id, [attribute], [attribute=value]\n */\nfunction elementMatches(el: Element, selector: string): boolean {\n  // Remove whitespace\n  selector = selector.trim()\n\n  // Check for attribute selector [attr] or [attr=value]\n  const attrMatch = selector.match(/^\\[([^\\]=]+)(?:=([^\\]]*))?\\]$/)\n  if (attrMatch) {\n    const [, attrName, attrValue] = attrMatch\n    if (attrValue === undefined) {\n      // Just checking if attribute exists\n      return attrName in el.attribs\n    } else {\n      // Check if attribute has specific value\n      return el.attribs?.[attrName] === attrValue\n    }\n  }\n\n  // Check for class selector .class\n  if (selector.startsWith('.')) {\n    const className = selector.slice(1)\n    const classes = el.attribs?.class?.split(/\\s+/) || []\n    return classes.includes(className)\n  }\n\n  // Check for id selector #id\n  if (selector.startsWith('#')) {\n    const id = selector.slice(1)\n    return el.attribs?.id === id\n  }\n\n  // Check for tag selector (possibly with attribute)\n  // Split tag from attribute if present, e.g., \"div[role=alert]\"\n  const tagAttrMatch = selector.match(/^([a-z][a-z0-9]*)\\[([^\\]]+)\\]$/i)\n  if (tagAttrMatch) {\n    const [, tagName, attrPart] = tagAttrMatch\n    if (el.name !== tagName) return false\n\n    // Parse attribute part: could be \"attr\" or \"attr=value\"\n    const attrEqMatch = attrPart.match(/^([^=]+)(?:=(.*))?$/)\n    if (attrEqMatch) {\n      const [, attrName, attrValue] = attrEqMatch\n      if (attrValue === undefined) {\n        return attrName in el.attribs\n      } else {\n        return el.attribs?.[attrName] === attrValue\n      }\n    }\n    return false\n  }\n\n  // Simple tag selector\n  return el.name === selector\n}\n"],"mappings":";;;;;;;;;AAQA,MAAM,qBAAgF;CACpF,OAAO;EACL,aAAa;EACb,aAAa;EACb,MAAM;CACR;CACA,KAAK,EACH,KAAK,GACP;AACF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8BA,SAAgB,cAAc,MAAc,SAA2B,CAAC,GAAW;CACjF,OAAO,UAAU,iBAAiB,MAAM,IAAI,GAAG,MAAM,CAAC;AACxD;;;;;;AAOA,SAAgB,iBAAiB,KAAkB,SAA2B,CAAC,GAAgB;CAC7F,MAAM,YAAY,OAAO;CAGzB,IAAI,cAAc,OAChB,OAAO;CAKT,MAAM,kBAAkBA,OADD,OAAO,cAAc,WAAW,YAAY,CAAC,GACtB,kBAAkB;CAGhE,KAAK,MAAM,CAAC,iBAAiB,eAAe,OAAO,QAAQ,eAAe,GAAG;EAE3E,IAAI,eAAe,OAAO;EAE1B,MAAM,YAAY,gBAAgB,MAAM,GAAG,CAAC,CAAC,KAAI,MAAK,EAAE,KAAK,CAAC;EAE9D,KAAK,MAAM,SAAS;GAClB,MAAM,KAAK;GACX,IAAI,CAAC,GAAG,MAAM;GAKd,IAFgB,UAAU,MAAK,aAAY,eAAe,IAAI,QAAQ,CAE5D,GAAG;IAEX,IAAI,CAAC,GAAG,SACN,GAAG,UAAU,CAAC;IAGhB,KAAK,MAAM,CAAC,UAAU,cAAc,OAAO,QAAQ,UAAU,GAAG;KAE9D,IAAI,cAAc,OAAO;KAEzB,IAAI,aAAa,WAAW,GAAG,QAAQ,OAAO;MAC5C,MAAM,kBAAkB,GAAG,QAAQ,MAAM,MAAM,KAAK,CAAC,CAAC,OAAO,OAAO;MACpE,MAAM,aAAa,OAAO,SAAS,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,OAAO,OAAO;MAChE,MAAM,gBAAgB,CAAC,mBAAG,IAAI,IAAI,CAAC,GAAG,iBAAiB,GAAG,UAAU,CAAC,CAAC;MACtE,IAAI,cAAc,KAAK,GAAG,MAAM,GAAG,QAAQ,OACzC,GAAG,QAAQ,QAAQ,cAAc,KAAK,GAAG;KAE7C,OAEE,IAAI,EAAE,YAAY,GAAG,UACnB,GAAG,QAAQ,YAAY,OAAO,SAAS;IAG7C;GACF;EACF,CAAC;CACH;CAEA,OAAO;AACT;;;;;AAMA,SAAS,eAAe,IAAa,UAA2B;CAE9D,WAAW,SAAS,KAAK;CAGzB,MAAM,YAAY,SAAS,MAAM,+BAA+B;CAChE,IAAI,WAAW;EACb,MAAM,GAAG,UAAU,aAAa;EAChC,IAAI,cAAc,KAAA,GAEhB,OAAO,YAAY,GAAG;OAGtB,OAAO,GAAG,UAAU,cAAc;CAEtC;CAGA,IAAI,SAAS,WAAW,GAAG,GAAG;EAC5B,MAAM,YAAY,SAAS,MAAM,CAAC;EAElC,QADgB,GAAG,SAAS,OAAO,MAAM,KAAK,KAAK,CAAC,EAAA,CACrC,SAAS,SAAS;CACnC;CAGA,IAAI,SAAS,WAAW,GAAG,GAAG;EAC5B,MAAM,KAAK,SAAS,MAAM,CAAC;EAC3B,OAAO,GAAG,SAAS,OAAO;CAC5B;CAIA,MAAM,eAAe,SAAS,MAAM,iCAAiC;CACrE,IAAI,cAAc;EAChB,MAAM,GAAG,SAAS,YAAY;EAC9B,IAAI,GAAG,SAAS,SAAS,OAAO;EAGhC,MAAM,cAAc,SAAS,MAAM,qBAAqB;EACxD,IAAI,aAAa;GACf,MAAM,GAAG,UAAU,aAAa;GAChC,IAAI,cAAc,KAAA,GAChB,OAAO,YAAY,GAAG;QAEtB,OAAO,GAAG,UAAU,cAAc;EAEtC;EACA,OAAO;CACT;CAGA,OAAO,GAAG,SAAS;AACrB"}

package/dist/transformers/sixHex.js

@@ -4,7 +4,7 @@ import { serialize } from "../utils/ast/serializer.js";
 import "../utils/ast/index.js";
 import { conv } from "color-shorthand-hex-to-six-digit";
 //#region src/transformers/sixHex.ts
-const targets = new Set(["bgcolor", "color"]);
+const targets = /* @__PURE__ */ new Set(["bgcolor", "color"]);
 /**
 * Convert 3-digit HEX color codes to 6-digit in `bgcolor` and `color`
 * attributes, for better email client compatibility.

package/dist/transformers/sixHex.js.map

@@ -1 +1 @@
-{"version":3,"file":"sixHex.js","names":[],"sources":["../../src/transformers/sixHex.ts"],"sourcesContent":["import { conv } from 'color-shorthand-hex-to-six-digit'\nimport type { ChildNode, Element } from 'domhandler'\nimport { parse, serialize, walk } from '../utils/ast/index.ts'\n\nconst targets = new Set(['bgcolor', 'color'])\n\n/**\n * Convert 3-digit HEX color codes to 6-digit in `bgcolor` and `color`\n * attributes, for better email client compatibility.\n *\n * @param html HTML string to transform.\n * @returns    The transformed HTML string.\n *\n * @example\n * import { sixHex } from '@maizzle/framework'\n *\n * const out = sixHex('<font color=\"#abc\">x</font>')\n */\nexport function sixHex(html: string): string {\n  return serialize(sixHexDom(parse(html)))\n}\n\n/**\n * DOM-form of {@link sixHex} used by the internal transformer pipeline.\n * Takes a parsed DOM, returns a parsed DOM — avoids redundant\n * serialize/parse round-trips when chained with other transformers.\n */\nexport function sixHexDom(dom: ChildNode[]): ChildNode[] {\n  walk(dom, (node) => {\n    const el = node as Element\n\n    if (!el.attribs) {\n      return\n    }\n\n    for (const attr of targets) {\n      const value = el.attribs[attr]\n\n      if (value) {\n        el.attribs[attr] = conv(value)\n      }\n    }\n  })\n\n  return dom\n}\n"],"mappings":";;;;;;AAIA,MAAM,UAAU,IAAI,IAAI,CAAC,WAAW,OAAO,CAAC;;;;;;;;;;;;;AAc5C,SAAgB,OAAO,MAAsB;CAC3C,OAAO,UAAU,UAAU,MAAM,IAAI,CAAC,CAAC;AACzC;;;;;;AAOA,SAAgB,UAAU,KAA+B;CACvD,KAAK,MAAM,SAAS;EAClB,MAAM,KAAK;EAEX,IAAI,CAAC,GAAG,SACN;EAGF,KAAK,MAAM,QAAQ,SAAS;GAC1B,MAAM,QAAQ,GAAG,QAAQ;GAEzB,IAAI,OACF,GAAG,QAAQ,QAAQ,KAAK,KAAK;EAEjC;CACF,CAAC;CAED,OAAO;AACT"}
+{"version":3,"file":"sixHex.js","names":[],"sources":["../../src/transformers/sixHex.ts"],"sourcesContent":["import { conv } from 'color-shorthand-hex-to-six-digit'\nimport type { ChildNode, Element } from 'domhandler'\nimport { parse, serialize, walk } from '../utils/ast/index.ts'\n\nconst targets = new Set(['bgcolor', 'color'])\n\n/**\n * Convert 3-digit HEX color codes to 6-digit in `bgcolor` and `color`\n * attributes, for better email client compatibility.\n *\n * @param html HTML string to transform.\n * @returns    The transformed HTML string.\n *\n * @example\n * import { sixHex } from '@maizzle/framework'\n *\n * const out = sixHex('<font color=\"#abc\">x</font>')\n */\nexport function sixHex(html: string): string {\n  return serialize(sixHexDom(parse(html)))\n}\n\n/**\n * DOM-form of {@link sixHex} used by the internal transformer pipeline.\n * Takes a parsed DOM, returns a parsed DOM — avoids redundant\n * serialize/parse round-trips when chained with other transformers.\n */\nexport function sixHexDom(dom: ChildNode[]): ChildNode[] {\n  walk(dom, (node) => {\n    const el = node as Element\n\n    if (!el.attribs) {\n      return\n    }\n\n    for (const attr of targets) {\n      const value = el.attribs[attr]\n\n      if (value) {\n        el.attribs[attr] = conv(value)\n      }\n    }\n  })\n\n  return dom\n}\n"],"mappings":";;;;;;AAIA,MAAM,0BAAU,IAAI,IAAI,CAAC,WAAW,OAAO,CAAC;;;;;;;;;;;;;AAc5C,SAAgB,OAAO,MAAsB;CAC3C,OAAO,UAAU,UAAU,MAAM,IAAI,CAAC,CAAC;AACzC;;;;;;AAOA,SAAgB,UAAU,KAA+B;CACvD,KAAK,MAAM,SAAS;EAClB,MAAM,KAAK;EAEX,IAAI,CAAC,GAAG,SACN;EAGF,KAAK,MAAM,QAAQ,SAAS;GAC1B,MAAM,QAAQ,GAAG,QAAQ;GAEzB,IAAI,OACF,GAAG,QAAQ,QAAQ,KAAK,KAAK;EAEjC;CACF,CAAC;CAED,OAAO;AACT"}

package/dist/types/config.d.ts

@@ -586,6 +586,21 @@ interface MaizzleConfig {
      * @default 3000
      */
     port?: number;
+    /**
+     * Expose the dev server on the network.
+     *
+     * Set to `true` to listen on all interfaces (prints a network URL +
+     * QR code), or pass a string to bind a specific address. The
+     * `--host` CLI flag takes precedence over this.
+     *
+     * @default false
+     *
+     * @example
+     * server: {
+     *   host: true,
+     * }
+     */
+    host?: boolean | string;
     /**
      * Additional file paths to watch for changes.
      *

package/dist/types/config.d.ts.map

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

package/dist/utils/ast/serializer.js

@@ -1,6 +1,6 @@
 import render from "dom-serializer";
 //#region src/utils/ast/serializer.ts
-const RAW_TEXT_ELEMENTS = new Set(["script", "style"]);
+const RAW_TEXT_ELEMENTS = /* @__PURE__ */ new Set(["script", "style"]);
 /**
 * Re-encode `<` and `>` in text nodes before serialization.
 *

package/dist/utils/ast/serializer.js.map

@@ -1 +1 @@
-{"version":3,"file":"serializer.js","names":[],"sources":["../../../src/utils/ast/serializer.ts"],"sourcesContent":["import render from 'dom-serializer'\nimport type { ChildNode, Element, Text } from 'domhandler'\nimport type { DomSerializerOptions } from 'dom-serializer'\n\nconst RAW_TEXT_ELEMENTS = new Set(['script', 'style'])\n\n/**\n * Re-encode `<` and `>` in text nodes before serialization.\n *\n * The parser decodes entities like `&lt;` into raw `<` in text nodes. With\n * `encodeEntities: false` (needed so other transformers can emit entity\n * strings such as `&nbsp;` verbatim), the serializer would write those raw\n * `<` characters as-is, turning escaped text (e.g. a Vue `{{ html }}`\n * interpolation containing `<p>...</p>`) into real DOM downstream.\n *\n * `&` is intentionally not re-encoded: the `entities` transformer writes\n * literal entity strings (`&nbsp;`, `&mdash;`) directly into text-node data\n * and relies on the serializer leaving them alone.\n *\n * Skip `<script>` / `<style>` — their children are raw-text containers, and\n * CSS/JS legitimately contains `<` and `>`.\n */\nfunction encodeTextNodes(dom: ChildNode[], inRawText = false): void {\n  for (const node of dom) {\n    if (node.type === 'text') {\n      if (!inRawText) {\n        const text = node as Text\n        text.data = text.data\n          .replace(/</g, '&lt;')\n          .replace(/>/g, '&gt;')\n      }\n      continue\n    }\n\n    if ('children' in node && (node as Element).children?.length) {\n      const el = node as Element\n      const nextRaw = inRawText || RAW_TEXT_ELEMENTS.has(el.name)\n      encodeTextNodes(el.children as ChildNode[], nextRaw)\n    }\n  }\n}\n\nexport function serialize(dom: ChildNode[], options?: DomSerializerOptions): string {\n  encodeTextNodes(dom)\n  return render(dom, { encodeEntities: false, ...options })\n}\n"],"mappings":";;AAIA,MAAM,oBAAoB,IAAI,IAAI,CAAC,UAAU,OAAO,CAAC;;;;;;;;;;;;;;;;;AAkBrD,SAAS,gBAAgB,KAAkB,YAAY,OAAa;CAClE,KAAK,MAAM,QAAQ,KAAK;EACtB,IAAI,KAAK,SAAS,QAAQ;GACxB,IAAI,CAAC,WAAW;IACd,MAAM,OAAO;IACb,KAAK,OAAO,KAAK,KACd,QAAQ,MAAM,MAAM,CAAC,CACrB,QAAQ,MAAM,MAAM;GACzB;GACA;EACF;EAEA,IAAI,cAAc,QAAS,KAAiB,UAAU,QAAQ;GAC5D,MAAM,KAAK;GACX,MAAM,UAAU,aAAa,kBAAkB,IAAI,GAAG,IAAI;GAC1D,gBAAgB,GAAG,UAAyB,OAAO;EACrD;CACF;AACF;AAEA,SAAgB,UAAU,KAAkB,SAAwC;CAClF,gBAAgB,GAAG;CACnB,OAAO,OAAO,KAAK;EAAE,gBAAgB;EAAO,GAAG;CAAQ,CAAC;AAC1D"}
+{"version":3,"file":"serializer.js","names":[],"sources":["../../../src/utils/ast/serializer.ts"],"sourcesContent":["import render from 'dom-serializer'\nimport type { ChildNode, Element, Text } from 'domhandler'\nimport type { DomSerializerOptions } from 'dom-serializer'\n\nconst RAW_TEXT_ELEMENTS = new Set(['script', 'style'])\n\n/**\n * Re-encode `<` and `>` in text nodes before serialization.\n *\n * The parser decodes entities like `&lt;` into raw `<` in text nodes. With\n * `encodeEntities: false` (needed so other transformers can emit entity\n * strings such as `&nbsp;` verbatim), the serializer would write those raw\n * `<` characters as-is, turning escaped text (e.g. a Vue `{{ html }}`\n * interpolation containing `<p>...</p>`) into real DOM downstream.\n *\n * `&` is intentionally not re-encoded: the `entities` transformer writes\n * literal entity strings (`&nbsp;`, `&mdash;`) directly into text-node data\n * and relies on the serializer leaving them alone.\n *\n * Skip `<script>` / `<style>` — their children are raw-text containers, and\n * CSS/JS legitimately contains `<` and `>`.\n */\nfunction encodeTextNodes(dom: ChildNode[], inRawText = false): void {\n  for (const node of dom) {\n    if (node.type === 'text') {\n      if (!inRawText) {\n        const text = node as Text\n        text.data = text.data\n          .replace(/</g, '&lt;')\n          .replace(/>/g, '&gt;')\n      }\n      continue\n    }\n\n    if ('children' in node && (node as Element).children?.length) {\n      const el = node as Element\n      const nextRaw = inRawText || RAW_TEXT_ELEMENTS.has(el.name)\n      encodeTextNodes(el.children as ChildNode[], nextRaw)\n    }\n  }\n}\n\nexport function serialize(dom: ChildNode[], options?: DomSerializerOptions): string {\n  encodeTextNodes(dom)\n  return render(dom, { encodeEntities: false, ...options })\n}\n"],"mappings":";;AAIA,MAAM,oCAAoB,IAAI,IAAI,CAAC,UAAU,OAAO,CAAC;;;;;;;;;;;;;;;;;AAkBrD,SAAS,gBAAgB,KAAkB,YAAY,OAAa;CAClE,KAAK,MAAM,QAAQ,KAAK;EACtB,IAAI,KAAK,SAAS,QAAQ;GACxB,IAAI,CAAC,WAAW;IACd,MAAM,OAAO;IACb,KAAK,OAAO,KAAK,KACd,QAAQ,MAAM,MAAM,CAAC,CACrB,QAAQ,MAAM,MAAM;GACzB;GACA;EACF;EAEA,IAAI,cAAc,QAAS,KAAiB,UAAU,QAAQ;GAC5D,MAAM,KAAK;GACX,MAAM,UAAU,aAAa,kBAAkB,IAAI,GAAG,IAAI;GAC1D,gBAAgB,GAAG,UAAyB,OAAO;EACrD;CACF;AACF;AAEA,SAAgB,UAAU,KAAkB,SAAwC;CAClF,gBAAgB,GAAG;CACnB,OAAO,OAAO,KAAK;EAAE,gBAAgB;EAAO,GAAG;CAAQ,CAAC;AAC1D"}

package/dist/utils/cssBox.js

@@ -1,5 +1,5 @@
 //#region src/utils/cssBox.ts
-const NO_BORDER_STYLES = new Set(["none", "hidden"]);
+const NO_BORDER_STYLES = /* @__PURE__ */ new Set(["none", "hidden"]);
 /**
 * Parse a length token into px. Handles `Npx`, `Nrem`, `Nem`, `Npt`, and
 * unitless N (treated as px). Returns null for percentages, calc(),

package/dist/utils/cssBox.js.map

@@ -1 +1 @@
-{"version":3,"file":"cssBox.js","names":[],"sources":["../../src/utils/cssBox.ts"],"sourcesContent":["import type { Root } from 'postcss'\n\nexport const NO_BORDER_STYLES = new Set(['none', 'hidden'])\n\n/**\n * Parse a length token into px. Handles `Npx`, `Nrem`, `Nem`, `Npt`, and\n * unitless N (treated as px). Returns null for percentages, calc(),\n * keywords, or anything that doesn't reduce to a concrete length.\n */\nexport function lengthToPx(value: string): number | null {\n  const m = value.trim().match(/^([\\d.]+)(px|rem|em|pt)?$/i)\n  if (!m) return null\n  const n = parseFloat(m[1])\n  const unit = (m[2] || 'px').toLowerCase()\n  return n * (unit === 'rem' || unit === 'em' ? 16 : unit === 'pt' ? 1.333 : 1)\n}\n\n/**\n * Expand a 1-4 token CSS shorthand (T R B L) into a left/right pair:\n *   1: all sides\n *   2: TB RL\n *   3: T RL B\n *   4: T R B L\n */\nexport function shorthandSides(value: string): { left?: string; right?: string } {\n  const parts = value.trim().split(/\\s+/)\n  switch (parts.length) {\n    case 1: return { left: parts[0], right: parts[0] }\n    case 2:\n    case 3: return { left: parts[1], right: parts[1] }\n    case 4: return { left: parts[3], right: parts[1] }\n    default: return {}\n  }\n}\n\n/**\n * Read horizontal padding (left + right) px from a parsed style root.\n * Percentages are skipped since they'd need a known container width.\n */\nexport function horizontalPaddingPx(root: Root): number {\n  let left: number | null = null\n  let right: number | null = null\n\n  root.walkDecls((d) => {\n    switch (d.prop) {\n      case 'padding': {\n        const { left: l, right: r } = shorthandSides(d.value)\n        if (l) left = lengthToPx(l)\n        if (r) right = lengthToPx(r)\n        break\n      }\n      case 'padding-left':\n        left = lengthToPx(d.value)\n        break\n      case 'padding-right':\n        right = lengthToPx(d.value)\n        break\n    }\n  })\n\n  return (left ?? 0) + (right ?? 0)\n}\n\n/**\n * Extract a px length from a CSS border shorthand (e.g. `1px solid red` → 1).\n * Returns null when the value indicates no border (`none` or `hidden`).\n * Defaults to 3px (CSS `medium`) when a visible style is set but no\n * explicit width token is present in the shorthand value.\n */\nexport function shorthandBorderWidthPx(value: string): number | null {\n  const tokens = value.trim().split(/\\s+/)\n  if (tokens.some((t) => NO_BORDER_STYLES.has(t.toLowerCase()))) return null\n  for (const t of tokens) {\n    const px = lengthToPx(t)\n    if (px != null) return px\n  }\n  return 3\n}\n\n/**\n * Read horizontal border widths (left + right) px from a parsed style root.\n * Per-side `border-style: none|hidden` overrides count as zero\n * contribution. Returns total px or 0 when nothing resolves.\n */\nexport function horizontalBorderPx(root: Root): number {\n  let left: number | null = null\n  let right: number | null = null\n  let leftNone = false\n  let rightNone = false\n\n  root.walkDecls((d) => {\n    switch (d.prop) {\n      case 'border': {\n        const w = shorthandBorderWidthPx(d.value)\n        if (w == null) {\n          leftNone = rightNone = true\n        }\n        else {\n          left = right = w\n          leftNone = rightNone = false\n        }\n        break\n      }\n      case 'border-width': {\n        const { left: l, right: r } = shorthandSides(d.value)\n        if (l) left = lengthToPx(l) ?? left\n        if (r) right = lengthToPx(r) ?? right\n        break\n      }\n      case 'border-style': {\n        const { left: l, right: r } = shorthandSides(d.value)\n        if (l && NO_BORDER_STYLES.has(l.toLowerCase())) leftNone = true\n        if (r && NO_BORDER_STYLES.has(r.toLowerCase())) rightNone = true\n        break\n      }\n      case 'border-left': {\n        const w = shorthandBorderWidthPx(d.value)\n        if (w == null) leftNone = true\n        else { left = w; leftNone = false }\n        break\n      }\n      case 'border-right': {\n        const w = shorthandBorderWidthPx(d.value)\n        if (w == null) rightNone = true\n        else { right = w; rightNone = false }\n        break\n      }\n      case 'border-left-width':\n        left = lengthToPx(d.value) ?? left\n        break\n      case 'border-right-width':\n        right = lengthToPx(d.value) ?? right\n        break\n      case 'border-left-style':\n        if (NO_BORDER_STYLES.has(d.value.trim().toLowerCase())) leftNone = true\n        break\n      case 'border-right-style':\n        if (NO_BORDER_STYLES.has(d.value.trim().toLowerCase())) rightNone = true\n        break\n    }\n  })\n\n  return (leftNone ? 0 : (left ?? 0)) + (rightNone ? 0 : (right ?? 0))\n}\n"],"mappings":"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"}
+{"version":3,"file":"cssBox.js","names":[],"sources":["../../src/utils/cssBox.ts"],"sourcesContent":["import type { Root } from 'postcss'\n\nexport const NO_BORDER_STYLES = new Set(['none', 'hidden'])\n\n/**\n * Parse a length token into px. Handles `Npx`, `Nrem`, `Nem`, `Npt`, and\n * unitless N (treated as px). Returns null for percentages, calc(),\n * keywords, or anything that doesn't reduce to a concrete length.\n */\nexport function lengthToPx(value: string): number | null {\n  const m = value.trim().match(/^([\\d.]+)(px|rem|em|pt)?$/i)\n  if (!m) return null\n  const n = parseFloat(m[1])\n  const unit = (m[2] || 'px').toLowerCase()\n  return n * (unit === 'rem' || unit === 'em' ? 16 : unit === 'pt' ? 1.333 : 1)\n}\n\n/**\n * Expand a 1-4 token CSS shorthand (T R B L) into a left/right pair:\n *   1: all sides\n *   2: TB RL\n *   3: T RL B\n *   4: T R B L\n */\nexport function shorthandSides(value: string): { left?: string; right?: string } {\n  const parts = value.trim().split(/\\s+/)\n  switch (parts.length) {\n    case 1: return { left: parts[0], right: parts[0] }\n    case 2:\n    case 3: return { left: parts[1], right: parts[1] }\n    case 4: return { left: parts[3], right: parts[1] }\n    default: return {}\n  }\n}\n\n/**\n * Read horizontal padding (left + right) px from a parsed style root.\n * Percentages are skipped since they'd need a known container width.\n */\nexport function horizontalPaddingPx(root: Root): number {\n  let left: number | null = null\n  let right: number | null = null\n\n  root.walkDecls((d) => {\n    switch (d.prop) {\n      case 'padding': {\n        const { left: l, right: r } = shorthandSides(d.value)\n        if (l) left = lengthToPx(l)\n        if (r) right = lengthToPx(r)\n        break\n      }\n      case 'padding-left':\n        left = lengthToPx(d.value)\n        break\n      case 'padding-right':\n        right = lengthToPx(d.value)\n        break\n    }\n  })\n\n  return (left ?? 0) + (right ?? 0)\n}\n\n/**\n * Extract a px length from a CSS border shorthand (e.g. `1px solid red` → 1).\n * Returns null when the value indicates no border (`none` or `hidden`).\n * Defaults to 3px (CSS `medium`) when a visible style is set but no\n * explicit width token is present in the shorthand value.\n */\nexport function shorthandBorderWidthPx(value: string): number | null {\n  const tokens = value.trim().split(/\\s+/)\n  if (tokens.some((t) => NO_BORDER_STYLES.has(t.toLowerCase()))) return null\n  for (const t of tokens) {\n    const px = lengthToPx(t)\n    if (px != null) return px\n  }\n  return 3\n}\n\n/**\n * Read horizontal border widths (left + right) px from a parsed style root.\n * Per-side `border-style: none|hidden` overrides count as zero\n * contribution. Returns total px or 0 when nothing resolves.\n */\nexport function horizontalBorderPx(root: Root): number {\n  let left: number | null = null\n  let right: number | null = null\n  let leftNone = false\n  let rightNone = false\n\n  root.walkDecls((d) => {\n    switch (d.prop) {\n      case 'border': {\n        const w = shorthandBorderWidthPx(d.value)\n        if (w == null) {\n          leftNone = rightNone = true\n        }\n        else {\n          left = right = w\n          leftNone = rightNone = false\n        }\n        break\n      }\n      case 'border-width': {\n        const { left: l, right: r } = shorthandSides(d.value)\n        if (l) left = lengthToPx(l) ?? left\n        if (r) right = lengthToPx(r) ?? right\n        break\n      }\n      case 'border-style': {\n        const { left: l, right: r } = shorthandSides(d.value)\n        if (l && NO_BORDER_STYLES.has(l.toLowerCase())) leftNone = true\n        if (r && NO_BORDER_STYLES.has(r.toLowerCase())) rightNone = true\n        break\n      }\n      case 'border-left': {\n        const w = shorthandBorderWidthPx(d.value)\n        if (w == null) leftNone = true\n        else { left = w; leftNone = false }\n        break\n      }\n      case 'border-right': {\n        const w = shorthandBorderWidthPx(d.value)\n        if (w == null) rightNone = true\n        else { right = w; rightNone = false }\n        break\n      }\n      case 'border-left-width':\n        left = lengthToPx(d.value) ?? left\n        break\n      case 'border-right-width':\n        right = lengthToPx(d.value) ?? right\n        break\n      case 'border-left-style':\n        if (NO_BORDER_STYLES.has(d.value.trim().toLowerCase())) leftNone = true\n        break\n      case 'border-right-style':\n        if (NO_BORDER_STYLES.has(d.value.trim().toLowerCase())) rightNone = true\n        break\n    }\n  })\n\n  return (leftNone ? 0 : (left ?? 0)) + (rightNone ? 0 : (right ?? 0))\n}\n"],"mappings":"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"}

package/node_modules/maizzle/dist/commands/new.mjs

@@ -122,9 +122,9 @@ async function newProject(starterArg, dirArg, options = {}) {
 			starter: async () => {
 				const starter = await p.select({
 					message: "Select a Starter",
-					initialValue: "maizzle/maizzle#next",
+					initialValue: "maizzle/maizzle#master",
 					options: [{
-						value: "maizzle/maizzle#next",
+						value: "maizzle/maizzle#master",
 						label: "Default"
 					}, {
 						value: "custom",

package/node_modules/maizzle/node_modules/commander/Readme.md

@@ -76,7 +76,7 @@ The two most used option types are a boolean option, and an option which takes i
 Example file: [split.js](./examples/split.js)
 
 ```js
-const { program } = require('commander');
+import { program } from 'commander';
 
 program
   .option('--first')
@@ -91,10 +91,10 @@ console.log(program.args[0].split(options.separator, limit));
 ```
 
 ```console
-$ node split.js -s / --fits a/b/c
+$ node split.js -s - --fits a-b-c
 error: unknown option '--fits'
 (Did you mean --first?)
-$ node split.js -s / --first a/b/c
+$ node split.js -s - --first a-b-c
 [ 'a' ]
 ```
 
@@ -103,7 +103,7 @@ Here is a more complete program using a subcommand and with descriptions for the
 Example file: [string-util.js](./examples/string-util.js)
 
 ```js
-const { Command } = require('commander');
+import { Command } from 'commander';
 const program = new Command();
 
 program
@@ -138,7 +138,7 @@ Options:
   -s, --separator <char>  separator character (default: ",")
   -h, --help              display help for command
 
-$ node string-util.js split --separator=/ a/b/c
+$ node string-util.js split --separator=- a-b-c
 [ 'a', 'b', 'c' ]
 ```
 
@@ -147,11 +147,10 @@ More samples can be found in the [examples](https://github.com/tj/commander.js/t
 ## Declaring _program_ variable
 
 Commander exports a global object which is convenient for quick programs.
-This is used in the examples in this README for brevity.
+This is used in some examples in this README for brevity.
 
 ```js
-// CommonJS (.cjs)
-const { program } = require('commander');
+import { program } from 'commander';
 ```
 
 For larger programs which may use commander in multiple ways, including unit testing, it is better to create a local `Command` object to use.
@@ -276,10 +275,7 @@ cheese: stilton
 ### Other option types, negatable boolean and boolean|value
 
 You can define a boolean option long name with a leading `no-` to set the option value to `false` when used.
-Defined alone, this also makes the option `true` by default.
-
-If you define `--foo` first, adding `--no-foo` does not change the default value from what it would
-otherwise be.
+Defined alone without a matching positive option, this also makes the option `true` by default.
 
 Example file: [options-negatable.js](./examples/options-negatable.js)
 
@@ -558,7 +554,7 @@ Configuration options can be passed with the call to `.command()` and `.addComma
 remove the command from the generated help output. Specifying `isDefault: true` will run the subcommand if no other
 subcommand is specified. (Example file: [defaultCommand.js](./examples/defaultCommand.js).)
 
-You can add alternative names for a command with `.alias()`. (Example file: [alias.js](./examples/alias.js).)
+You can add alternative names for a command with `.alias()`. (Example file: [alias.cjs](./examples/alias.cjs).)
 
 `.command()` automatically copies the inherited settings from the parent command to the newly created subcommand. This is only done during creation; any later setting changes to the parent are not inherited.
 
@@ -1060,7 +1056,7 @@ node -r ts-node/register pm.ts
 This factory function creates a new command. It is exported and may be used instead of using `new`, like:
 
 ```js
-const { createCommand } = require('commander');
+import { createCommand } from 'commander';
 const program = createCommand();
 ```
 
@@ -1163,7 +1159,7 @@ There is more information available about:
 
 ## Support
 
-The current version of Commander is fully supported on Long Term Support versions of Node.js, and requires at least v20.
+The current version of Commander is fully supported on Long Term Support versions of Node.js, and requires at least v22.12.0.
 
 Older major versions of Commander receive security updates for 12 months. For more see: [Release Policy](./docs/release-policy.md).
 

package/node_modules/maizzle/node_modules/commander/index.js

@@ -1,24 +1,21 @@
-const { Argument } = require('./lib/argument.js');
-const { Command } = require('./lib/command.js');
-const { CommanderError, InvalidArgumentError } = require('./lib/error.js');
-const { Help } = require('./lib/help.js');
-const { Option } = require('./lib/option.js');
+import { Argument } from './lib/argument.js';
+import { Command } from './lib/command.js';
+import { CommanderError, InvalidArgumentError } from './lib/error.js';
+import { Help } from './lib/help.js';
+import { Option } from './lib/option.js';
 
-exports.program = new Command();
+export const program = new Command();
 
-exports.createCommand = (name) => new Command(name);
-exports.createOption = (flags, description) => new Option(flags, description);
-exports.createArgument = (name, description) => new Argument(name, description);
+export const createCommand = (name) => new Command(name);
+export const createOption = (flags, description) =>
+  new Option(flags, description);
+export const createArgument = (name, description) =>
+  new Argument(name, description);
 
 /**
  * Expose classes
  */
 
-exports.Command = Command;
-exports.Option = Option;
-exports.Argument = Argument;
-exports.Help = Help;
-
-exports.CommanderError = CommanderError;
-exports.InvalidArgumentError = InvalidArgumentError;
-exports.InvalidOptionArgumentError = InvalidArgumentError; // Deprecated
+export { Command, Option, Argument, Help };
+export { CommanderError, InvalidArgumentError };
+export { InvalidArgumentError as InvalidOptionArgumentError }; // Deprecated

package/node_modules/maizzle/node_modules/commander/lib/argument.js

@@ -1,6 +1,6 @@
-const { InvalidArgumentError } = require('./error.js');
+import { InvalidArgumentError } from './error.js';
 
-class Argument {
+export class Argument {
   /**
    * Initialize a new command argument with the given name and description.
    * The default is that the argument is required, and you can explicitly
@@ -140,11 +140,8 @@ class Argument {
  * @private
  */
 
-function humanReadableArgName(arg) {
+export function humanReadableArgName(arg) {
   const nameOutput = arg.name() + (arg.variadic === true ? '...' : '');
 
   return arg.required ? '<' + nameOutput + '>' : '[' + nameOutput + ']';
 }
-
-exports.Argument = Argument;
-exports.humanReadableArgName = humanReadableArgName;

package/node_modules/maizzle/node_modules/commander/lib/command.js

@@ -1,16 +1,17 @@
-const EventEmitter = require('node:events').EventEmitter;
-const childProcess = require('node:child_process');
-const path = require('node:path');
-const fs = require('node:fs');
-const process = require('node:process');
+import { EventEmitter } from 'node:events';
+import childProcess from 'node:child_process';
+import path from 'node:path';
+import fs from 'node:fs';
+import process from 'node:process';
+import { stripVTControlCharacters } from 'node:util';
 
-const { Argument, humanReadableArgName } = require('./argument.js');
-const { CommanderError } = require('./error.js');
-const { Help, stripColor } = require('./help.js');
-const { Option, DualOptions } = require('./option.js');
-const { suggestSimilar } = require('./suggestSimilar');
+import { Argument, humanReadableArgName } from './argument.js';
+import { CommanderError } from './error.js';
+import { Help } from './help.js';
+import { Option, DualOptions } from './option.js';
+import { suggestSimilar } from './suggestSimilar.js';
 
-class Command extends EventEmitter {
+export class Command extends EventEmitter {
   /**
    * Initialize a new `Command`.
    *
@@ -70,7 +71,7 @@ class Command extends EventEmitter {
         useColor() ?? (process.stdout.isTTY && process.stdout.hasColors?.()),
       getErrHasColors: () =>
         useColor() ?? (process.stderr.isTTY && process.stderr.hasColors?.()),
-      stripColor: (str) => stripColor(str),
+      stripColor: (str) => stripVTControlCharacters(str),
     };
 
     this._hidden = false;
@@ -674,17 +675,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
     const name = option.attributeName();
 
     // store default value
-    if (option.negate) {
-      // --no-foo is special and defaults foo to true, unless a --foo option is already defined
-      const positiveLongFlag = option.long.replace(/^--no-/, '--');
-      if (!this._findOption(positiveLongFlag)) {
-        this.setOptionValueWithSource(
-          name,
-          option.defaultValue === undefined ? true : option.defaultValue,
-          'default',
-        );
-      }
-    } else if (option.defaultValue !== undefined) {
+    if (option.defaultValue !== undefined) {
       this.setOptionValueWithSource(name, option.defaultValue, 'default');
     }
 
@@ -1125,7 +1116,29 @@ Expecting one of '${allowedValues.join("', '")}'`);
   }
 
   _prepareForParse() {
+    // Save the state the first time, then restore the state before each subsequent parse.
     if (this._savedState === null) {
+      // Do the special default of lone negated option to true, now that we have all the options.
+      // Filter for negated options that have not been processed already.
+      this.options
+        .filter(
+          (option) =>
+            option.negate &&
+            option.defaultValue === undefined &&
+            this.getOptionValue(option.attributeName()) === undefined,
+        )
+        .forEach((option) => {
+          // check for lone negated option: --no-foo without a --foo option
+          const positiveLongFlag = option.long.replace(/^--no-/, '--');
+          if (!this._findOption(positiveLongFlag)) {
+            this.setOptionValueWithSource(
+              option.attributeName(),
+              true,
+              'default',
+            );
+          }
+        });
+
       this.saveStateBeforeParse();
     } else {
       this.restoreStateBeforeParse();
@@ -1201,7 +1214,6 @@ Expecting one of '${allowedValues.join("', '")}'`);
 
   _executeSubCommand(subcommand, args) {
     args = args.slice();
-    let launchWithNode = false; // Use node for source targets so do not need to get permissions correct, and on Windows.
     const sourceExt = ['.js', '.ts', '.tsx', '.mjs', '.cjs'];
 
     function findFile(baseDir, baseName) {
@@ -1262,7 +1274,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
       executableFile = localFile || executableFile;
     }
 
-    launchWithNode = sourceExt.includes(path.extname(executableFile));
+    const launchWithNode = sourceExt.includes(path.extname(executableFile));
 
     let proc;
     if (process.platform !== 'win32') {
@@ -2148,8 +2160,10 @@ Expecting one of '${allowedValues.join("', '")}'`);
 
     const expected = this.registeredArguments.length;
     const s = expected === 1 ? '' : 's';
+    const received = receivedArgs.length;
     const forSubcommand = this.parent ? ` for '${this.name()}'` : '';
-    const message = `error: too many arguments${forSubcommand}. Expected ${expected} argument${s} but got ${receivedArgs.length}.`;
+    const details = receivedArgs.join(', ');
+    const message = `error: too many arguments${forSubcommand}. Expected ${expected} argument${s} but got ${received}: ${details}.`;
     this.error(message, { code: 'commander.excessArguments' });
   }
 
@@ -2405,12 +2419,12 @@ Expecting one of '${allowedValues.join("', '")}'`);
 
   /**
    * Set the name of the command from script filename, such as process.argv[1],
-   * or require.main.filename, or __filename.
+   * or import.meta.filename.
    *
    * (Used internally and public although not documented in README.)
    *
    * @example
-   * program.nameFromFilename(require.main.filename);
+   * program.nameFromFilename(import.meta.filename);
    *
    * @param {string} filename
    * @return {Command}
@@ -2426,7 +2440,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
    * Get or set the directory for searching for executable subcommands of this command.
    *
    * @example
-   * program.executableDir(__dirname);
+   * program.executableDir(import.meta.dirname);
    * // or
    * program.executableDir('subcommands');
    *
@@ -2746,10 +2760,12 @@ function incrementNodeInspectorPort(args) {
 }
 
 /**
+ * Exported for using from tests, not otherwise used outside this file.
+ *
  * @returns {boolean | undefined}
  * @package
  */
-function useColor() {
+export function useColor() {
   // Test for common conventions.
   // NB: the observed behaviour is in combination with how author adds color! For example:
   //   - we do not test NODE_DISABLE_COLORS, but util:styletext does
@@ -2772,6 +2788,3 @@ function useColor() {
     return true;
   return undefined;
 }
-
-exports.Command = Command;
-exports.useColor = useColor; // exporting for tests

package/node_modules/maizzle/node_modules/commander/lib/error.js

@@ -1,7 +1,7 @@
 /**
  * CommanderError class
  */
-class CommanderError extends Error {
+export class CommanderError extends Error {
   /**
    * Constructs the CommanderError class
    * @param {number} exitCode suggested exit code which could be used with process.exit
@@ -22,7 +22,7 @@ class CommanderError extends Error {
 /**
  * InvalidArgumentError class
  */
-class InvalidArgumentError extends CommanderError {
+export class InvalidArgumentError extends CommanderError {
   /**
    * Constructs the InvalidArgumentError class
    * @param {string} [message] explanation of why argument is invalid
@@ -34,6 +34,3 @@ class InvalidArgumentError extends CommanderError {
     this.name = this.constructor.name;
   }
 }
-
-exports.CommanderError = CommanderError;
-exports.InvalidArgumentError = InvalidArgumentError;

package/node_modules/maizzle/node_modules/commander/lib/help.js

@@ -1,4 +1,5 @@
-const { humanReadableArgName } = require('./argument.js');
+import { humanReadableArgName } from './argument.js';
+import { stripVTControlCharacters } from 'node:util';
 
 /**
  * TypeScript import types for JSDoc, used by Visual Studio Code IntelliSense and `npm run typescript-checkJS`
@@ -9,7 +10,7 @@ const { humanReadableArgName } = require('./argument.js');
  */
 
 // Although this is a class, methods are static in style to allow override using subclass or just functions.
-class Help {
+export class Help {
   constructor() {
     this.helpWidth = undefined;
     this.minWidthToWrap = 40;
@@ -533,7 +534,7 @@ class Help {
    * @returns {number}
    */
   displayWidth(str) {
-    return stripColor(str).length;
+    return stripVTControlCharacters(str).length;
   }
 
   /**
@@ -728,20 +729,3 @@ class Help {
     return wrappedLines.join('\n');
   }
 }
-
-/**
- * Strip style ANSI escape sequences from the string. In particular, SGR (Select Graphic Rendition) codes.
- *
- * @param {string} str
- * @returns {string}
- * @package
- */
-
-function stripColor(str) {
-  // eslint-disable-next-line no-control-regex
-  const sgrPattern = /\x1b\[\d*(;\d*)*m/g;
-  return str.replace(sgrPattern, '');
-}
-
-exports.Help = Help;
-exports.stripColor = stripColor;

package/node_modules/maizzle/node_modules/commander/lib/option.js

@@ -1,6 +1,6 @@
-const { InvalidArgumentError } = require('./error.js');
+import { InvalidArgumentError } from './error.js';
 
-class Option {
+export class Option {
   /**
    * Initialize a new `Option` with the given `flags` and `description`.
    *
@@ -265,7 +265,7 @@ class Option {
  * use cases, but is tricky for others where we want separate behaviours despite
  * the single shared option value.
  */
-class DualOptions {
+export class DualOptions {
   /**
    * @param {Option[]} options
    */
@@ -375,6 +375,3 @@ function splitOptionFlags(flags) {
 
   return { shortFlag, longFlag };
 }
-
-exports.Option = Option;
-exports.DualOptions = DualOptions;

package/node_modules/maizzle/node_modules/commander/lib/suggestSimilar.js

@@ -24,7 +24,7 @@ function editDistance(a, b) {
   // fill matrix
   for (let j = 1; j <= b.length; j++) {
     for (let i = 1; i <= a.length; i++) {
-      let cost = 1;
+      let cost;
       if (a[i - 1] === b[j - 1]) {
         cost = 0;
       } else {
@@ -53,7 +53,7 @@ function editDistance(a, b) {
  * @returns {string}
  */
 
-function suggestSimilar(word, candidates) {
+export function suggestSimilar(word, candidates) {
   if (!candidates || candidates.length === 0) return '';
   // remove possible duplicates
   candidates = Array.from(new Set(candidates));
@@ -97,5 +97,3 @@ function suggestSimilar(word, candidates) {
   }
   return '';
 }
-
-exports.suggestSimilar = suggestSimilar;