@maizzle/framework 6.0.0-rc.0 → 6.0.0-rc.10

package/dist/types/config.d.mts

@@ -1,65 +1,280 @@
 import { RemoveValue } from "../plugins/postcss/removeDeclarations.mjs";
+import { Directive, Plugin } from "vue";
+import { Options } from "juice";
 import * as oxfmt from "oxfmt";
-import * as unplugin_vue_markdown_types0 from "unplugin-vue-markdown/types";
+import { InlineConfig } from "vite";
+import * as shiki from "shiki";
+import { Options as Options$1 } from "unplugin-vue-markdown/types";
 
 //#region src/types/config.d.ts
 interface UrlQueryOptions {
+  /**
+   * CSS selectors for elements to process.
+   *
+   * @default ['a']
+   */
   tags?: string[];
+  /**
+   * HTML attributes containing URLs to append query params to.
+   *
+   * @default ['src', 'href', 'poster', 'srcset', 'background']
+   */
   attributes?: string[];
+  /**
+   * When `true`, only appends query params to absolute URLs.
+   *
+   * @default true
+   */
   strict?: boolean;
+  /**
+   * Options forwarded to the `query-string` library for controlling serialization.
+   *
+   * @default { encode: false }
+   */
   qs?: Record<string, unknown>;
 }
 type UrlQuery = Record<string, unknown> & {
   _options?: UrlQueryOptions;
 };
 interface UrlConfig {
+  /**
+   * Append query parameters to URLs in your HTML.
+   *
+   * @example
+   * url: {
+   *   query: {
+   *     utm_source: 'maizzle',
+   *     utm_medium: 'email',
+   *   }
+   * }
+   */
   query?: UrlQuery;
+  /**
+   * Prepend a base URL to relative paths.
+   *
+   * Pass a string to prepend to all tags, or an object for fine-grained control.
+   *
+   * @example
+   * url: {
+   *   base: 'https://cdn.example.com/emails/',
+   * }
+   */
   base?: string | {
-    url?: string;
-    tags?: string[] | Record<string, Record<string, string | boolean>>;
-    attributes?: Record<string, string>;
-    styleTag?: boolean;
+    /** The base URL to prepend. */url?: string; /** Tags or tag-attribute map to process. */
+    tags?: string[] | Record<string, Record<string, string | boolean>>; /** Attributes to process. */
+    attributes?: Record<string, string>; /** Also apply to URLs in `<style>` tags. */
+    styleTag?: boolean; /** Also apply to URLs in inline `style` attributes. */
     inlineCss?: boolean;
   };
 }
 interface CssConfig {
+  /**
+   * Base directory for Tailwind CSS `@source` resolution.
+   *
+   * Automatically set to `root` when `root` is configured.
+   */
   base?: string;
+  /**
+   * Remove unused CSS.
+   *
+   * Set to `true` to enable with defaults, or pass an options object.
+   *
+   * @default false
+   */
   purge?: boolean | Record<string, unknown>;
-  inline?: boolean | {
+  /**
+   * Inline CSS from `<style>` tags into matching HTML elements.
+   *
+   * Set to `true` to enable with defaults, or pass an options object for fine-grained control.
+   *
+   * @example
+   * css: {
+   *   inline: {
+   *     removeStyleTags: true,
+   *     applyWidthAttributes: true,
+   *   }
+   * }
+   */
+  inline?: boolean | Options & {
+    /**
+     * Convert HTML attributes like `width`, `height`, `bgcolor`, and `valign`
+     * to inline CSS styles. Set to `true` for all, or pass an array of attribute names.
+     *
+     * @default false
+     */
     attributeToStyle?: boolean | string[];
-    removeStyleTags?: boolean;
-    removeInlinedSelectors?: boolean;
+    /**
+     * Convert `0px`, `0em` etc. to `0` in inline styles.
+     *
+     * @default true
+     */
     preferUnitlessValues?: boolean;
+    /**
+     * CSS selectors to preserve in `<style>` tags, even after inlining.
+     * Mapped to Juice's `preservedSelectors` option.
+     *
+     * @default []
+     */
     safelist?: string[];
+    /**
+     * Duplicate CSS properties to HTML attributes.
+     * Mapped to Juice's static `styleToAttribute` property.
+     *
+     * @default {}
+     *
+     * @example
+     * styleToAttribute: {
+     *   'background-color': 'bgcolor',
+     * }
+     */
     styleToAttribute?: Record<string, string>;
-    applyWidthAttributes?: boolean;
-    applyHeightAttributes?: boolean;
+    /**
+     * Elements that can receive `width` HTML attributes.
+     * Mapped to Juice's static `widthElements` property.
+     *
+     * @default ['img', 'video']
+     */
     widthElements?: string[];
+    /**
+     * Elements that can receive `height` HTML attributes.
+     * Mapped to Juice's static `heightElements` property.
+     *
+     * @default ['img', 'video']
+     */
     heightElements?: string[];
+    /**
+     * CSS properties to exclude from inlining.
+     * Mapped to Juice's static `excludedProperties` property.
+     *
+     * @default []
+     */
     excludedProperties?: string[];
+    /**
+     * Template language code blocks to preserve during inlining.
+     * Mapped to Juice's static `codeBlocks` property.
+     *
+     * @default { EJS: { start: '<%', end: '%>' }, HBS: { start: '\{\{', end: '}}' } }
+     */
     codeBlocks?: Record<string, {
       start: string;
       end: string;
     }>;
+    /**
+     * Additional CSS string to inline alongside `<style>` tag contents.
+     * Mapped to Juice's `extraCss` option.
+     */
     customCSS?: string;
-    [key: string]: unknown;
   };
+  /**
+   * Merge duplicate `@media` queries and sort them.
+   *
+   * Enabled by default. Set to `false` to disable, or pass an object to control sort order.
+   *
+   * @default true
+   *
+   * @example
+   * css: {
+   *   media: { sort: 'desktop-first' },
+   * }
+   */
   media?: boolean | {
+    /**
+     * Sort order for media queries.
+     *
+     * @default 'mobile-first'
+     */
     sort?: 'mobile-first' | 'desktop-first' | ((a: string, b: string) => number);
   };
+  /**
+   * Convert unitless CSS values to their unitless equivalents.
+   *
+   * For example, `line-height: 24px` with a `16px` font becomes `line-height: 1.5`.
+   *
+   * @default true
+   */
   preferUnitless?: boolean;
+  /**
+   * Resolve CSS `calc()` expressions to static values where possible.
+   *
+   * @default true
+   */
   resolveCalc?: boolean;
+  /**
+   * Resolve CSS custom properties (`var()`) to their computed values.
+   *
+   * @default true
+   */
   resolveProps?: boolean;
+  /**
+   * Replace unsafe CSS class names with email-safe equivalents.
+   *
+   * @default true
+   */
   safe?: boolean | Record<string, string>;
-  sixHex?: boolean;
+  /**
+   * Rewrite longhand CSS to shorthand where possible.
+   *
+   * For example, `padding: 10px 20px 10px 20px` becomes `padding: 10px 20px`.
+   *
+   * @default false
+   */
   shorthand?: boolean | {
     tags?: string[];
   };
+  /**
+   * Convert 3-digit HEX colors to 6-digit in `bgcolor` and `color` attributes.
+   *
+   * Some email clients don't support shorthand HEX like `#fff`.
+   *
+   * @default true
+   */
+  sixHex?: boolean;
+  /**
+   * Remove specific CSS declarations by selector.
+   *
+   * @example
+   * css: {
+   *   removeDeclarations: {
+   *     ':root': '*',
+   *   }
+   * }
+   */
   removeDeclarations?: Record<string, RemoveValue>;
+  /**
+   * File paths to exclude from CSS processing.
+   *
+   * @example
+   * css: {
+   *   exclude: ['emails/amp/**'],
+   * }
+   */
   exclude?: string[];
 }
 interface AttributesConfig {
+  /**
+   * Add attributes to HTML elements.
+   *
+   * @example
+   * html: {
+   *   attributes: {
+   *     add: {
+   *       table: { cellpadding: 0, cellspacing: 0, role: 'none' },
+   *       img: { alt: '' },
+   *     }
+   *   }
+   * }
+   */
   add?: false | Record<string, Record<string, string | boolean | number>>;
+  /**
+   * Remove attributes from HTML elements by name or name-value pair.
+   *
+   * @example
+   * html: {
+   *   attributes: {
+   *     remove: ['data-test', { name: 'class', value: /^js-/ }],
+   *   }
+   * }
+   */
   remove?: Array<string | {
     name: string;
     value?: string | RegExp;
@@ -67,57 +282,284 @@ interface AttributesConfig {
 }
 type EntitiesConfig = boolean | Record<string, string>;
 interface PostcssConfig {
-  /** Selector prefixes to strip from compiled CSS (e.g. ':host', ':lang'). */
+  /**
+   * Selector prefixes to strip from compiled CSS.
+   *
+   * @default [':host', ':lang']
+   *
+   * @example
+   * postcss: {
+   *   removeSelectors: [':host', ':lang', ':root'],
+   * }
+   */
   removeSelectors?: string[];
-  /** At-rule names to strip from compiled CSS (e.g. '@layer', '@property'). */
+  /**
+   * At-rule names to strip from compiled CSS.
+   *
+   * @default ['layer', 'property']
+   *
+   * @example
+   * postcss: {
+   *   removeAtRules: ['layer', 'property', 'charset'],
+   * }
+   */
   removeAtRules?: string[];
-  [key: string]: unknown;
 }
 interface HtmlConfig {
+  /** Configure HTML attribute transformations. */
   attributes?: AttributesConfig;
+  /**
+   * Decode HTML entities.
+   *
+   * Set to `true` to decode all, or pass a map of entities to decode.
+   *
+   * @default true
+   */
   decodeEntities?: EntitiesConfig;
+  /**
+   * Pretty-print the HTML output.
+   *
+   * Set to `true` to enable with defaults, or pass options.
+   */
   format?: boolean | oxfmt.FormatOptions;
+  /**
+   * Minify the HTML output.
+   *
+   * Set to `true` to enable with defaults, or pass options.
+   */
   minify?: boolean | Record<string, unknown>;
 }
+type FilterFunction = (str: string, value: string) => string;
+type FiltersConfig = false | Record<string, FilterFunction>;
+interface MarkdownConfig extends Options$1 {
+  /**
+   * The shiki theme to use for syntax highlighting in Markdown fenced code blocks.
+   *
+   * @default 'github-light'
+   */
+  shikiTheme?: shiki.BundledTheme;
+}
+interface VueConfig {
+  /** Vue plugins to register on the app instance before rendering. */
+  plugins?: Plugin[];
+  /** Custom Vue directives to register globally. */
+  directives?: Record<string, Directive>;
+  /** Properties added to `app.config.globalProperties`, available in all templates. */
+  globalProperties?: Record<string, unknown>;
+}
 interface MaizzleConfig {
-  markdown?: unplugin_vue_markdown_types0.Options;
+  /**
+   * Root directory for the Maizzle email project.
+   *
+   * When set, relative paths for `content`, `static.source`,
+   * and `css.base` are all resolved relative to this directory.
+   *
+   * Defaults to `process.cwd()`.
+   *
+   * @example
+   * maizzle({
+   *   root: 'resources/js/emails',
+   *   content: ['./**\/*.vue'],
+   * })
+   */
+  root?: string;
+  /** Options for Markdown template support, extending `unplugin-vue-markdown`. */
+  markdown?: MarkdownConfig;
+  /**
+   * Glob patterns for email template files to process.
+   *
+   * Resolved relative to `root`.
+   *
+   * @default ['emails/**\/*.{vue,md}']
+   */
   content?: string[];
+  /** Output configuration for built email templates. */
   output?: {
+    /**
+     * Directory to write compiled HTML files to.
+     *
+     * @default 'dist'
+     */
     path?: string;
+    /**
+     * File extension for compiled templates.
+     *
+     * @default 'html'
+     *
+     * @example
+     * output: {
+     *   extension: 'blade.php',
+     * }
+     */
     extension?: string;
   };
+  /** Static file copying configuration. */
   static?: {
+    /**
+     * Glob patterns for static files to copy to the output directory.
+     *
+     * @default ['public/**\/*.*']
+     */
     source?: string[];
+    /**
+     * Subdirectory in the output folder where static files are placed.
+     *
+     * @default 'public'
+     */
     destination?: string;
   };
+  /** Component auto-import configuration. */
+  components?: {
+    /**
+     * Additional directories to scan for auto-imported Vue components.
+     *
+     * Resolved relative to `cwd` (not `root`), so paths outside the
+     * email root directory work as expected.
+     *
+     * @example
+     * components: {
+     *   source: ['resources/js/components/email'],
+     * }
+     */
+    source?: string | string[];
+  };
+  /** Dev server configuration. */
   server?: {
+    /**
+     * Port for the dev server.
+     *
+     * @default 3000
+     */
     port?: number;
+    /**
+     * Additional file paths to watch for changes.
+     *
+     * @default []
+     *
+     * @example
+     * server: {
+     *   watch: ['./tailwind.config.ts'],
+     * }
+     */
     watch?: string[];
+    /**
+     * Email sending configuration for the "Send test" feature in the dev UI.
+     *
+     * When not configured, falls back to Ethereal (free fake SMTP — emails
+     * are captured and viewable via a URL, never actually delivered).
+     *
+     * @example
+     * server: {
+     *   email: {
+     *     to: ['test@example.com'],
+     *     from: 'dev@maizzle.test',
+     *     transport: {
+     *       host: 'smtp.mailtrap.io',
+     *       port: 587,
+     *       auth: { user: '...', pass: '...' },
+     *     },
+     *   },
+     * }
+     */
+    email?: {
+      /** Default recipient(s). */to?: string | string[]; /** Sender address. @default 'Maizzle <maizzle@ethereal.email>' */
+      from?: string; /** Default subject line. */
+      subject?: string; /** Nodemailer transport options (SMTP, SES, etc.). Omit to use Ethereal. */
+      transport?: Record<string, unknown>;
+    };
   };
+  /** Tailwind CSS and email CSS optimization settings. */
   css?: CssConfig;
+  /**
+   * Generate a plaintext version of the email.
+   *
+   * Set to `true` to enable, or pass a string path or options object.
+   *
+   * @default false
+   */
   plaintext?: boolean | string | Record<string, unknown>;
+  /** PostCSS processing options. */
   postcss?: PostcssConfig;
+  /**
+   * Enable the transformer pipeline (CSS inlining, purging, shorthand, etc).
+   *
+   * @default true
+   */
   useTransformers?: boolean;
+  /**
+   * Replace strings in the final HTML output.
+   *
+   * @example
+   * replaceStrings: {
+   *   '{{ year }}': new Date().getFullYear().toString(),
+   * }
+   */
   replaceStrings?: Record<string, string>;
+  /**
+   * Content filters that transform text inside HTML elements using custom attributes.
+   *
+   * Set to `false` to disable all filters. Pass an object to add custom filters
+   * (merged with built-in defaults).
+   *
+   * @example
+   * filters: {
+   *   uppercase: str => str.toUpperCase(),
+   * }
+   */
+  filters?: FiltersConfig;
+  /** URL transformation settings (base URL, query string appending). */
   url?: UrlConfig;
+  /** HTML post-processing settings (attributes, formatting, minification). */
   html?: HtmlConfig;
+  /**
+   * Vite configuration options passed to the internal Vite SSR server.
+   *
+   * Use this to add custom Vite plugins or other Vite options.
+   * If a `vite.config.{ts,js}` file exists in the project root, it takes
+   * precedence and this option is used as a fallback.
+   *
+   * @example
+   * vite: {
+   *   plugins: [myPlugin()],
+   * }
+   */
+  vite?: InlineConfig;
+  /**
+   * Vue app customization options.
+   *
+   * Register plugins, directives, or global properties on the
+   * internal Vue app instance used for SSR rendering.
+   *
+   * @example
+   * vue: {
+   *   plugins: [createI18n({ locale: 'en', messages })],
+   *   directives: { focus: vFocus },
+   *   globalProperties: { $format: dateFormat },
+   * }
+   */
+  vue?: VueConfig;
+  /** Called before any templates are processed. */
   beforeCreate?: (params: {
     config: MaizzleConfig;
   }) => void | Promise<void>;
+  /** Called before each template is rendered. Return a string to replace the template source. */
   beforeRender?: (params: {
     config: MaizzleConfig;
     template: string;
   }) => string | void | Promise<string | void>;
+  /** Called after each template is rendered but before transformers run. Return a string to replace the output HTML. */
   afterRender?: (params: {
     config: MaizzleConfig;
     template: string;
     html: string;
   }) => string | void | Promise<string | void>;
+  /** Called after transformers have run on each template. Return a string to replace the output HTML. */
   afterTransform?: (params: {
     config: MaizzleConfig;
     template: string;
     html: string;
   }) => string | void | Promise<string | void>;
+  /** Called after all templates have been built. */
   afterBuild?: (params: {
     files: string[];
     config: MaizzleConfig;
@@ -125,5 +567,5 @@ interface MaizzleConfig {
   [key: string]: any;
 }
 //#endregion
-export { AttributesConfig, CssConfig, EntitiesConfig, HtmlConfig, MaizzleConfig, PostcssConfig, UrlConfig, UrlQuery, UrlQueryOptions };
+export { AttributesConfig, CssConfig, EntitiesConfig, FilterFunction, FiltersConfig, HtmlConfig, MaizzleConfig, MarkdownConfig, PostcssConfig, UrlConfig, UrlQuery, UrlQueryOptions, VueConfig };
 //# sourceMappingURL=config.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"config.d.mts","names":[],"sources":["../../src/types/config.ts"],"mappings":";;;;;UAAiB,eAAA;EACf,IAAA;EACA,UAAA;EACA,MAAA;EACA,EAAA,GAAK,MAAA;AAAA;AAAA,KAGK,QAAA,GAAW,MAAA;EACrB,QAAA,GAAW,eAAA;AAAA;AAAA,UAGI,SAAA;EACf,KAAA,GAAQ,QAAA;EACR,IAAA;IACE,GAAA;IACA,IAAA,cAAkB,MAAA,SAAe,MAAA;IACjC,UAAA,GAAa,MAAA;IACb,QAAA;IACA,SAAA;EAAA;AAAA;AAAA,UAIa,SAAA;EACf,IAAA;EACA,KAAA,aAAkB,MAAA;EAClB,MAAA;IACE,gBAAA;IACA,eAAA;IACA,sBAAA;IACA,oBAAA;IACA,QAAA;IACA,gBAAA,GAAmB,MAAA;IACnB,oBAAA;IACA,qBAAA;IACA,aAAA;IACA,cAAA;IACA,kBAAA;IACA,UAAA,GAAa,MAAA;MAAiB,KAAA;MAAe,GAAA;IAAA;IAC7C,SAAA;IAAA,CACC,GAAA;EAAA;EAEH,KAAA;IACE,IAAA,wCAA4C,CAAA,UAAW,CAAA;EAAA;EAEzD,cAAA;EACA,WAAA;EACA,YAAA;EACA,IAAA,aAAiB,MAAA;EACjB,MAAA;EACA,SAAA;IAAwB,IAAA;EAAA;EACxB,kBAAA,GAAqB,MAAA,SAHE,WAAA;EAIvB,OAAA;AAAA;AAAA,UAGe,gBAAA;EACf,GAAA,WAAc,MAAA,SAAe,MAAA;EAC7B,MAAA,GAAS,KAAA;IAAiB,IAAA;IAAc,KAAA,YAAiB,MAAA;EAAA;AAAA;AAAA,KAG/C,cAAA,aAA2B,MAAA;AAAA,UAEtB,aAAA;EAjCb;EAmCF,eAAA;EAjCE;EAmCF,aAAA;EAAA,CACC,GAAA;AAAA;AAAA,UAGc,UAAA;EACf,UAAA,GAAa,gBAAA;EACb,cAAA,GAAiB,cAAA;EACjB,MAAA,aAD+B,KAAA,CACI,aAAA;EACnC,MAAA,aAAmB,MAAA;AAAA;AAAA,UAGJ,aAAA;EACf,QAAA,GAD4B,4BAAA,CACqB,OAAA;EACjD,OAAA;EACA,MAAA;IACE,IAAA;IACA,SAAA;EAAA;EAEF,MAAA;IACE,MAAA;IACA,WAAA;EAAA;EAEF,MAAA;IACE,IAAA;IACA,KAAA;EAAA;EAEF,GAAA,GAAM,SAAA;EACN,SAAA,sBAA+B,MAAA;EAC/B,OAAA,GAAU,aAAA;EACV,eAAA;EACA,cAAA,GAAiB,MAAA;EACjB,GAAA,GAAM,SAAA;EACN,IAAA,GAAO,UAAA;EAGP,YAAA,IAAgB,MAAA;IAAU,MAAA,EAAQ,aAAA;EAAA,aAA2B,OAAA;EAC7D,YAAA,IAAgB,MAAA;IAAU,MAAA,EAAQ,aAAA;IAAe,QAAA;EAAA,sBAAuC,OAAA;EACxF,WAAA,IAAe,MAAA;IAAU,MAAA,EAAQ,aAAA;IAAe,QAAA;IAAkB,IAAA;EAAA,sBAAmC,OAAA;EACrG,cAAA,IAAkB,MAAA;IAAU,MAAA,EAAQ,aAAA;IAAe,QAAA;IAAkB,IAAA;EAAA,sBAAmC,OAAA;EACxG,UAAA,IAAc,MAAA;IAAU,KAAA;IAAiB,MAAA,EAAQ,aAAA;EAAA,aAA2B,OAAA;EAAA,CAG3E,GAAA;AAAA"}
+{"version":3,"file":"config.d.mts","names":[],"sources":["../../src/types/config.ts"],"mappings":"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"}

package/dist/types/index.d.mts

@@ -1,2 +1,2 @@
-import { AttributesConfig, CssConfig, EntitiesConfig, HtmlConfig, MaizzleConfig, PostcssConfig, UrlConfig, UrlQuery, UrlQueryOptions } from "./config.mjs";
-export { type AttributesConfig, type CssConfig, type EntitiesConfig, type HtmlConfig, type MaizzleConfig, type PostcssConfig, type UrlConfig, type UrlQuery, type UrlQueryOptions };
+import { AttributesConfig, CssConfig, EntitiesConfig, FilterFunction, FiltersConfig, HtmlConfig, MaizzleConfig, MarkdownConfig, PostcssConfig, UrlConfig, UrlQuery, UrlQueryOptions } from "./config.mjs";
+export { type AttributesConfig, type CssConfig, type EntitiesConfig, type FilterFunction, type FiltersConfig, type HtmlConfig, type MaizzleConfig, type MarkdownConfig, type PostcssConfig, type UrlConfig, type UrlQuery, type UrlQueryOptions };

package/dist/utils/ast/serializer.d.mts

@@ -1,7 +1,8 @@
-import { ChildNode, DomHandlerOptions } from "domhandler";
+import { ChildNode } from "domhandler";
+import { DomSerializerOptions } from "dom-serializer";
 
 //#region src/utils/ast/serializer.d.ts
-declare function serialize(dom: ChildNode[], options?: DomHandlerOptions): string;
+declare function serialize(dom: ChildNode[], options?: DomSerializerOptions): string;
 //#endregion
 export { serialize };
 //# sourceMappingURL=serializer.d.mts.map

package/dist/utils/ast/serializer.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"serializer.d.mts","names":[],"sources":["../../../src/utils/ast/serializer.ts"],"mappings":";;;iBAGgB,SAAA,CAAU,GAAA,EAAK,SAAA,IAAa,OAAA,GAAU,iBAAA"}
+{"version":3,"file":"serializer.d.mts","names":[],"sources":["../../../src/utils/ast/serializer.ts"],"mappings":";;;;iBA6BgB,SAAA,CAAU,GAAA,EAAK,SAAA,IAAa,OAAA,GAAU,oBAAA"}

package/dist/utils/ast/serializer.mjs

@@ -1,7 +1,31 @@
+import { walk } from "./walker.mjs";
 import render from "dom-serializer";
 
 //#region src/utils/ast/serializer.ts
+/**
+* Re-encode < and > as entities in text nodes inside <code> elements.
+*
+* The DOM parser decodes entities like &#x3C; into raw < in text nodes.
+* With encodeEntities: false the serializer outputs them as-is, which
+* creates broken HTML (e.g. </a> inside a code block closes the real tag).
+*
+* We selectively fix this for <code> contents only, so the rest of the
+* document (where encodeEntities: false is needed) is unaffected.
+*/
+function encodeCodeTextNodes(dom) {
+	walk(dom, (node) => {
+		const el = node;
+		if (el.name !== "code") return;
+		walk(el.children ?? [], (child) => {
+			if (child.type === "text") {
+				const text = child;
+				text.data = text.data.replace(/</g, "&lt;").replace(/>/g, "&gt;");
+			}
+		});
+	});
+}
 function serialize(dom, options) {
+	encodeCodeTextNodes(dom);
 	return render(dom, {
 		encodeEntities: false,
 		...options

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

@@ -1 +1 @@
-{"version":3,"file":"serializer.mjs","names":[],"sources":["../../../src/utils/ast/serializer.ts"],"sourcesContent":["import render from 'dom-serializer'\nimport type { ChildNode, DomHandlerOptions } from 'domhandler'\n\nexport function serialize(dom: ChildNode[], options?: DomHandlerOptions): string {\n  return render(dom, { encodeEntities: false, ...options })\n}\n"],"mappings":";;;AAGA,SAAgB,UAAU,KAAkB,SAAqC;AAC/E,QAAO,OAAO,KAAK;EAAE,gBAAgB;EAAO,GAAG;EAAS,CAAC"}
+{"version":3,"file":"serializer.mjs","names":[],"sources":["../../../src/utils/ast/serializer.ts"],"sourcesContent":["import render from 'dom-serializer'\nimport type { ChildNode } from 'domhandler'\nimport type { DomSerializerOptions } from 'dom-serializer'\nimport { walk } from './walker.ts'\n\n/**\n * Re-encode < and > as entities in text nodes inside <code> elements.\n *\n * The DOM parser decodes entities like &#x3C; into raw < in text nodes.\n * With encodeEntities: false the serializer outputs them as-is, which\n * creates broken HTML (e.g. </a> inside a code block closes the real tag).\n *\n * We selectively fix this for <code> contents only, so the rest of the\n * document (where encodeEntities: false is needed) is unaffected.\n */\nfunction encodeCodeTextNodes(dom: ChildNode[]): void {\n  walk(dom, (node) => {\n    const el = node as import('domhandler').Element\n    if (el.name !== 'code') return\n\n    walk(el.children ?? [], (child) => {\n      if (child.type === 'text') {\n        const text = child as import('domhandler').Text\n        text.data = text.data.replace(/</g, '&lt;').replace(/>/g, '&gt;')\n      }\n    })\n  })\n}\n\nexport function serialize(dom: ChildNode[], options?: DomSerializerOptions): string {\n  encodeCodeTextNodes(dom)\n  return render(dom, { encodeEntities: false, ...options })\n}\n"],"mappings":";;;;;;;;;;;;;;AAeA,SAAS,oBAAoB,KAAwB;AACnD,MAAK,MAAM,SAAS;EAClB,MAAM,KAAK;AACX,MAAI,GAAG,SAAS,OAAQ;AAExB,OAAK,GAAG,YAAY,EAAE,GAAG,UAAU;AACjC,OAAI,MAAM,SAAS,QAAQ;IACzB,MAAM,OAAO;AACb,SAAK,OAAO,KAAK,KAAK,QAAQ,MAAM,OAAO,CAAC,QAAQ,MAAM,OAAO;;IAEnE;GACF;;AAGJ,SAAgB,UAAU,KAAkB,SAAwC;AAClF,qBAAoB,IAAI;AACxB,QAAO,OAAO,KAAK;EAAE,gBAAgB;EAAO,GAAG;EAAS,CAAC"}

package/dist/utils/detect.d.mts

@@ -0,0 +1,5 @@
+//#region src/utils/detect.d.ts
+declare function isLaravel(cwd?: string): boolean;
+//#endregion
+export { isLaravel };
+//# sourceMappingURL=detect.d.mts.map

package/dist/utils/detect.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.d.mts","names":[],"sources":["../../src/utils/detect.ts"],"mappings":";iBAGgB,SAAA,CAAU,GAAA"}

package/dist/utils/detect.mjs

@@ -0,0 +1,11 @@
+import { existsSync } from "node:fs";
+import { resolve } from "node:path";
+
+//#region src/utils/detect.ts
+function isLaravel(cwd = process.cwd()) {
+	return existsSync(resolve(cwd, "artisan"));
+}
+
+//#endregion
+export { isLaravel };
+//# sourceMappingURL=detect.mjs.map

package/dist/utils/detect.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.mjs","names":[],"sources":["../../src/utils/detect.ts"],"sourcesContent":["import { existsSync } from 'node:fs'\nimport { resolve } from 'node:path'\n\nexport function isLaravel(cwd: string = process.cwd()): boolean {\n  return existsSync(resolve(cwd, 'artisan'))\n}\n"],"mappings":";;;;AAGA,SAAgB,UAAU,MAAc,QAAQ,KAAK,EAAW;AAC9D,QAAO,WAAW,QAAQ,KAAK,UAAU,CAAC"}