@staticbolt/core 1.0.0-beta.0

package/lib/plugins/index.d.mts

@@ -0,0 +1,1181 @@
+import postcss from "postcss";
+import { Config } from "svgo";
+import * as babel from "@babel/core";
+import { Pluggable } from "unified";
+import { Plugin } from "@staticbolt/core";
+
+//#region src/plugins/analyze-output/analyze-output-plugin.d.ts
+interface AnalyzeOutputOptions {
+  /**
+   * Delete unused files from the output directory.
+   *
+   * @default false
+   */
+  deleteUnused?: boolean;
+  /**
+   * Log unused files.
+   *
+   * @default true
+   */
+  logUnusedFiles?: boolean;
+  /**
+   * Glob patterns to skip files when analyzing.
+   *
+   * @default ["robots.txt", "sitemap.xml", "sw.js", "workbox-*.js"]
+   */
+  exclude?: string[];
+  /**
+   * Specifies the size limit (in kilobytes) for each file type to trigger a warning. Set to `false` to disable warnings.
+   *
+   * @default { ".js": 150 }
+   */
+  maxFileSize?: Record<string, number> | false;
+}
+declare function analyzeOutputPlugin(options?: AnalyzeOutputOptions): Plugin;
+//#endregion
+//#region src/plugins/bundle-packages/bundle-packages-plugin.d.ts
+interface BundlePackagesOptions {
+  /** Output directory for bundled `node_modules` packages, relative to the build output directory. */
+  packagesDir?: string;
+  /**
+   * Whether to use Terser for minification to reduce the final bundle size.
+   *
+   * @default false
+   */
+  minifyUsingTerser?: boolean;
+  /**
+   * Bundles specific packages into a single chunk for optimized loading.
+   *
+   * Useful for grouping related libraries (e.g., all React dependencies) or bundling CommonJS modules for browser compatibility.
+   *
+   * @example
+   *   bundlePackagesPlugin({
+   *     "react-bundle": ["react", "react-dom", "react-dom/client", "react/jsx-runtime", "scheduler"],
+   *   });
+   *
+   * @key Chunk name
+   * @value Array of package names to include in the bundle
+   */
+  chunks?: Record<string, string[]>;
+  /**
+   * Custom package resolver entries to override default resolution logic.
+   *
+   * @example
+   *   bundlePackagesPlugin({
+   *     resolvePackage: {
+   *       "react-dom": {
+   *         "./client": {
+   *           production: "./cjs/react-dom.production.js",
+   *           development: "./cjs/react-dom.development.js",
+   *         },
+   *       },
+   *     },
+   *   });
+   *
+   * @default {}
+   */
+  resolvePackage?: Record<string, Record<string, string | {
+    production?: string;
+    development?: string;
+  }>>;
+}
+/**
+ * Bundles each `node_modules` package and its dependencies into separate files under `packagesDir`. The plugin scans files for
+ * imports and uses esbuild's tree-shaking capabilities to generate the bundles.
+ */
+declare function bundlePackagesPlugin(options?: BundlePackagesOptions): Plugin;
+//#endregion
+//#region src/plugins/convert-images/convert-images-plugin.d.ts
+type ImageFormat = "webp" | "avif" | "png" | "jpeg";
+type ImagePreset = "default" | "photo" | "picture" | "drawing" | "icon" | "text";
+interface ConvertImageOptions {
+  /**
+   * Format to convert images to.
+   *
+   * @default webp
+   */
+  format?: ImageFormat;
+  /**
+   * Image quality of the output image `(1-100)`.
+   *
+   * @default 100
+   */
+  quality?: number;
+  /**
+   * Presets for image compression (work for `WebP` format only).
+   *
+   * @default default
+   */
+  preset?: ImagePreset;
+  /**
+   * Glob patterns to include in image processing.
+   *
+   * @default ["sources/assets/**\/*.{jpg,jpeg,png}"]
+   */
+  include?: string[];
+  /**
+   * Glob patterns to ignore in image processing.
+   *
+   * @default [ ]
+   */
+  exclude?: string[];
+}
+declare function convertImagePlugin(options?: ConvertImageOptions): Plugin;
+//#endregion
+//#region src/plugins/copy-assets/copy-assets-plugin.d.ts
+interface CopyAssetsOptions {
+  /**
+   * Glob patterns to copy and include.
+   *
+   * @default ["sources/assets/**\/*"]
+   */
+  include?: string[];
+  /**
+   * Glob patterns to ignore and exclude when copying asset files.
+   *
+   * @default [ ]
+   */
+  exclude?: string[];
+}
+declare function copyAssetsPlugin(options?: CopyAssetsOptions): Plugin;
+//#endregion
+//#region src/plugins/custom-ease/easing-functions/types.d.ts
+type EaseFunction = (t: number) => number;
+interface CssLinear {
+  spring: (mass?: number, stiffness?: number, damping?: number, velocity?: number, duration?: number) => string;
+  inCirc: () => string;
+  inCubic: () => string;
+  inExpo: () => string;
+  inSine: () => string;
+  inQuad: () => string;
+  inQuart: () => string;
+  inQuint: () => string;
+  inBack: (c1?: number) => string;
+  inBounce: () => string;
+  inElastic: () => string;
+  inPoly: (n: number) => string;
+  inWobble: (bounciness: number) => string;
+  outCirc: () => string;
+  outCubic: () => string;
+  outExpo: () => string;
+  outSine: () => string;
+  outQuad: () => string;
+  outQuart: () => string;
+  outQuint: () => string;
+  outBack: (c1?: number) => string;
+  outBounce: () => string;
+  outElastic: () => string;
+  outPoly: (n: number) => string;
+  outWobble: (bounciness: number) => string;
+  inOutCirc: () => string;
+  inOutCubic: () => string;
+  inOutExpo: () => string;
+  inOutSine: () => string;
+  inOutQuad: () => string;
+  inOutQuart: () => string;
+  inOutQuint: () => string;
+  inOutBack: (c1?: number) => string;
+  inOutBounce: () => string;
+  inOutElastic: () => string;
+  inOutPoly: (n: number) => string;
+  inOutWobble: (bounciness: number) => string;
+}
+//#endregion
+//#region src/plugins/custom-ease/custom-ease-plugin.d.ts
+interface CustomEasePluginOptions {
+  /**
+   * Transform JS calls like `cssLinear.outCubic()` into their CSS easing string.
+   *
+   * @example
+   *   const ease = cssLinear.outCubic();
+   *   // → "cubic-bezier(0.215, 0.61, 0.355, 1)"
+   *
+   * @default false
+   */
+  replaceInJS?: boolean;
+  /**
+   * Name of the JS function namespace used for easing calls. The plugin looks for calls like `<name>.<ease>()`.
+   *
+   * @example
+   *   const ease = cssLinear.outCubic();
+   *
+   * @default "cssLinear"
+   */
+  jsFunctionName?: string;
+  /**
+   * Enable replacement of custom easing functions used in CSS.
+   *
+   * ```css
+   * :root {
+   *   --custom-ease: --ease-out-cubic();
+   * }
+   * ```
+   *
+   * @default true
+   */
+  replaceInCSS?: boolean;
+  /**
+   * Prefix used to detect custom easing functions in CSS. Any function starting with this prefix will be replaced.
+   *
+   * ```css
+   * :root {
+   *   --custom-ease: --ease-out-cubic();
+   * }
+   * ```
+   *
+   * @default "--ease-"
+   */
+  cssFunctionPrefix?: string;
+  /**
+   * Also process custom easing functions inside inline `style` attributes in HTML.
+   *
+   * ```html
+   * <div style="--custom-ease: --ease-out-cubic()"></div>
+   * ```
+   *
+   * @default false
+   */
+  replaceInHtmlStyleAttribute?: boolean;
+  /**
+   * Additional custom easing definitions. Values can be either:
+   *
+   * - A CSS easing string
+   * - A function returning a JS easing function
+   *
+   * @example
+   *   const customEase = {
+   *     "in-circ": "cubic-bezier(0.55, 0, 1, 0.45)",
+   *     "out-poly": (n: number) => (t: number) => 1 - Math.pow(1 - t, n),
+   *   };
+   */
+  customEase?: Record<string, string | ((...arguments_: unknown[]) => EaseFunction)>;
+  /**
+   * Number of samples used when converting easing functions to CSS `linear()`.
+   *
+   * Represents a balance between output quality and performance.
+   *
+   * @default 50
+   */
+  samples?: number;
+}
+declare function customEasePlugin(options?: CustomEasePluginOptions): Plugin;
+//#endregion
+//#region src/plugins/i18n/i18n-plugin.d.ts
+interface I18nPluginOptions {
+  /**
+   * The default locale.
+   *
+   * @default "en"
+   */
+  defaultLocale?: string;
+  /**
+   * The supported locales.
+   *
+   * @default ["en"]
+   */
+  supportedLocales?: string[];
+  /**
+   * The path to the locales directory.
+   *
+   * @default "./sources/locales"
+   */
+  localesDirectory?: string;
+  /**
+   * The name of the i18n attribute.
+   *
+   * @default "i18n"
+   */
+  i18nAttribute?: string;
+  /**
+   * The prefix to use for i18n attributes.
+   *
+   * @default "i18n-attr-"
+   */
+  i18nAttributePrefix?: string;
+  /**
+   * The prefix to use for i18n attributes.
+   *
+   * @default "i18n-placeholder-"
+   */
+  placeholderPrefix?: string;
+}
+declare function i18nPlugin(options?: I18nPluginOptions): Plugin[];
+//#endregion
+//#region src/plugins/import-as-string/types.d.ts
+interface ImportAsStringOptions {
+  /**
+   * - Whether to process the file and not just read it as a string.
+   * - **Default**: `true`
+   */
+  process?: boolean;
+  /**
+   * - Whether to minify the contents of the file when `process` is `true`.
+   * - **Default**: `false`
+   */
+  minify?: boolean;
+  /**
+   * - Whether to format the contents of the file when `process` is `true`.
+   * - **Default**: `false`
+   */
+  format?: boolean;
+  /**
+   * - Whether to wrap the inlined string in a template literal.
+   * - **Default**: `false`
+   */
+  templateLiteral?: boolean;
+}
+/** - Import a file and inline it as a string at build time. */
+type import_as_string = (filePath: string, options?: ImportAsStringOptions) => string;
+//#endregion
+//#region src/plugins/import-as-string/import-as-string-plugin.d.ts
+declare function importAsStringPlugin(): Plugin;
+//#endregion
+//#region src/plugins/load-sources/load-sources-plugin.d.ts
+interface LoadSourcesPluginOptions {
+  include: string[];
+  exclude?: string[];
+}
+declare function loadSourcesPlugin(options: LoadSourcesPluginOptions): Plugin;
+//#endregion
+//#region src/plugins/robots-text/robots-text-plugin.d.ts
+interface RobotsTextOptions {
+  /**
+   * Generate `robots.txt`.
+   *
+   * @default [ ]
+   */
+  rules?: {
+    userAgent: string;
+    allow?: string[];
+    disallow?: string[];
+  }[];
+  /**
+   * The output file path relative to output directory.
+   *
+   * @default "robots.txt"
+   */
+  outfile?: string;
+  /** The path to the sitemap file. */
+  sitemapUrl?: string;
+}
+declare function robotsTextPlugin(options?: RobotsTextOptions): Plugin;
+//#endregion
+//#region src/plugins/service-worker/service-worker-plugin.d.ts
+interface ServiceWorkerOptions {
+  /**
+   * Glob patterns for matching files.
+   *
+   * @default ["**\/*"]
+   */
+  globPatterns?: string[];
+  /**
+   * Glob patterns for files to ignore.
+   *
+   * @default ["**\/node_modules/**\/*"]
+   */
+  globIgnores?: string[];
+  /**
+   * Whether to follow symbolic links when matching glob patterns.
+   *
+   * @default true
+   */
+  globFollow?: boolean;
+  /**
+   * Enforces strict mode for glob patterns.
+   *
+   * @default true
+   */
+  globStrict?: boolean;
+  /**
+   * Destination file for the generated service worker relative to the output directory.
+   *
+   * @default "sw.js"
+   */
+  swDest?: string;
+  /**
+   * Determines whether source maps should be generated.
+   *
+   * @default false
+   */
+  sourcemap?: boolean;
+  /**
+   * Whether to skip waiting and immediately activate the service worker.
+   *
+   * @default true
+   */
+  skipWaiting?: boolean;
+  /**
+   * Whether the service worker should claim all available clients.
+   *
+   * @default true
+   */
+  clientsClaim?: boolean;
+  /**
+   * Whether to inline the Workbox runtime.
+   *
+   * @default false
+   */
+  inlineWorkboxRuntime?: boolean;
+  /**
+   * Cleans up outdated caches during service worker activation.
+   *
+   * @default true
+   */
+  cleanupOutdatedCaches?: boolean;
+  /**
+   * Enables offline Google Analytics support.
+   *
+   * @default false
+   */
+  offlineGoogleAnalytics?: boolean;
+  /** Cache ID used for versioning. */
+  cacheId?: string;
+  /** The default directory index for cached URLs. */
+  directoryIndex?: string;
+  /**
+   * Maximum file size (in bytes) to cache.
+   *
+   * @default 2097152
+   */
+  maximumFileSizeToCacheInBytes?: number;
+  /** Modifies URL prefixes for cached assets. */
+  modifyURLPrefix?: Record<string, string>;
+}
+/**
+ * Please don't forget to register the service worker in your HTML file.
+ *
+ * ```ts
+ * import { Workbox } from "workbox-window";
+ *
+ * if ("serviceWorker" in navigator && _production) {
+ *   const wb = new Workbox("/sw.js");
+ *   wb.register();
+ * }
+ * ```
+ */
+declare function serviceWorkerPlugin(options?: ServiceWorkerOptions): Plugin;
+//#endregion
+//#region src/plugins/sitemap/sitemap-plugin.d.ts
+interface SitemapOptions {
+  /** The URL of the sitemap. */
+  sitemapUrl?: string;
+  /**
+   * The output sitemap file path relative to the output directory.
+   *
+   * @default "sitemap.xml"
+   */
+  outfile?: string;
+  /**
+   * Glob patterns to match HTML files to include in the sitemap.
+   *
+   * **NOTE**: This is relative to the output directory.
+   *
+   * @default ["**\/*.html"]
+   */
+  include?: string[];
+  /**
+   * Glob patterns to ignore HTML files from the sitemap.
+   *
+   * **NOTE**: This is relative to the output directory.
+   *
+   * @default [ ]
+   */
+  exclude?: string[];
+}
+declare function sitemapPlugin(options?: SitemapOptions): Plugin;
+//#endregion
+//#region src/plugins/svgo/svgo-plugin.d.ts
+interface svgoOptions {
+  /**
+   * Include SVG files to optimize and write to output directory.
+   *
+   * @default ["sources/assets/**\/*.svg"]
+   */
+  include?: string[];
+  /**
+   * Ignore and exclude SVG files from optimization.
+   *
+   * @default [ ]
+   */
+  exclude?: string[];
+  /**
+   * Whether to optimize SVG tags in HTML.
+   *
+   * @default true
+   */
+  optimizeInHtml?: boolean;
+  /** SVGO configuration. */
+  svgoConfig?: Config;
+}
+/**
+ * Optimize SVG files and SVG tags in HTML using `svgo`.
+ *
+ * For CSS inlined SVGs, use a PostCSS plugin like `cssnano` instead.
+ *
+ * **Production Only**
+ */
+declare function svgoPlugin(options?: svgoOptions): Plugin;
+//#endregion
+//#region src/plugins/transform-css/transform-css-plugin.d.ts
+interface TransformCssOptions {
+  /** Postcss plugins. */
+  plugins?: readonly postcss.AcceptedPlugin[];
+  /**
+   * Whether to load postcss config file.
+   *
+   * @default false
+   */
+  loadConfig?: boolean;
+}
+declare function transformCssPlugin(options?: TransformCssOptions): Plugin;
+//#endregion
+//#region src/plugins/transform-js/transform-js-plugin.d.ts
+interface TransformJsPluginOptions {
+  presets?: babel.PluginItem[];
+  plugins?: babel.PluginItem[];
+}
+declare function transformJsPlugin(options?: TransformJsPluginOptions): Plugin;
+//#endregion
+//#region src/plugins/web-manifest/web-manifest-plugin.d.ts
+interface WebManifestOptions {
+  /**
+   * The file path to the manifest file relative to the root directory.
+   *
+   * @default "./sources/assets/manifest.json"
+   */
+  manifestPath?: string;
+  /**
+   * The output file path relative to the output directory.
+   *
+   * @default "./manifest.json"
+   */
+  outfile?: string;
+}
+declare function webManifestPlugin(options?: WebManifestOptions): Plugin;
+//#endregion
+//#region src/plugins/write-files/write-files-plugin.d.ts
+interface WriteFilesOptions {
+  /** Remove the output directory before emitting files. */
+  clean?: boolean;
+  /**
+   * Glob patterns to match files to write.
+   *
+   * @default ["**\/*"]
+   */
+  include?: string[];
+  /**
+   * Glob patterns to ignore files from writing.
+   *
+   * @default [ ]
+   */
+  exclude?: string[];
+  minify?: {
+    /**
+     * Whether to minify output.
+     *
+     * @default false
+     */
+    enabled?: boolean;
+    /**
+     * Glob patterns to match files to minify.
+     *
+     * @default ["**\/*"]
+     */
+    include?: string[];
+    /**
+     * Glob patterns to ignore files from minifying.
+     *
+     * @default [ ]
+     */
+    exclude?: string[];
+  };
+  format?: {
+    /**
+     * Whether to format output.
+     *
+     * @default false
+     */
+    enabled?: boolean;
+    /**
+     * Glob patterns to match files to format.
+     *
+     * @default ["**\/*"]
+     */
+    include?: string[];
+    /**
+     * Glob patterns to ignore files from formatting.
+     *
+     * @default [ ]
+     */
+    exclude?: string[];
+  };
+}
+declare function writeFilesPlugin(options: WriteFilesOptions): Plugin;
+//#endregion
+//#region src/plugins/html-build-time-script/html-build-time-script.d.ts
+interface HtmlBuildTimeScriptOptions {
+  /**
+   * The name of the attribute on the script tag that marks it for execution.
+   *
+   * @default "build-time"
+   */
+  buildAttribute?: string;
+  /**
+   * The name of the attribute on the script tag that enables full DOM context using `jsdom`, otherwise `node-html-parser` is
+   * used.
+   *
+   * @default "full-dom"
+   */
+  fullDomAttribute?: string;
+  contextAttribute?: string;
+}
+declare function htmlBuildTimeScript(options?: HtmlBuildTimeScriptOptions): Plugin;
+//#endregion
+//#region src/plugins/html-bundle-script/html-bundle-script-plugin.d.ts
+interface HtmlBundleScriptOptions {
+  /**
+   * Glob patterns for modules that should be treated as external (excluded from bundling).
+   *
+   * Applied when the `externalsAttribute` is not set on the script tag.
+   *
+   * @default [ ]
+   */
+  externals?: string[];
+  /**
+   * Glob patterns that exempt modules from being treated as external, even if they match `externals`.
+   *
+   * Applied when the `externalsExcludeAttribute` is not set on the script tag.
+   *
+   * @default [ ]
+   */
+  externalsExclude?: string[];
+  /**
+   * The HTML attribute name that enables bundling on a script tag.
+   *
+   * @default "bundle"
+   */
+  bundleAttribute?: string;
+  /**
+   * The HTML attribute name that specifies the output file path for the bundled script.
+   *
+   * @default "bundle-out"
+   */
+  bundleOutAttribute?: string;
+  /**
+   * The HTML attribute name that specifies which modules to treat as external.
+   *
+   * Accepts a semicolon-separated list of glob patterns.
+   *
+   * @default "bundle-externals"
+   */
+  externalsAttribute?: string;
+  /**
+   * The HTML attribute name that specifies which modules to exempt from being external.
+   *
+   * Accepts a semicolon-separated list of glob patterns.
+   *
+   * @default "bundle-externals-exclude"
+   */
+  externalsExcludeAttribute?: string;
+}
+/**
+ * A plugin that bundles `<script>` tags in HTML files using esbuild.
+ *
+ * Bundling is opt-in per script tag via the `bundle` attribute (configurable via {@link HtmlBundleScriptOptions.bundleAttribute}).
+ *
+ * **Inlining vs. separate file**
+ *
+ * - Inline script, no `bundle-out` attribute —> bundled output replaces the tag's content in place.
+ * - Inline script, `bundle-out` attribute set —> tag content is cleared and `src` is set to the output file.
+ * - `src` script, no `bundle-out` attribute —> bundle is written to `{filename}.bundle.js` and `src` is updated to point to it.
+ * - `src` script, `bundle-out` attribute set —> bundle is written to the specified path and `src` is updated to point to it.
+ *
+ * **Externals resolution**
+ *
+ * Glob patterns in {@link HtmlBundleScriptOptions.externals} and {@link HtmlBundleScriptOptions.externalsExclude} are matched
+ * against each resolved module path. A module is treated as external if it matches `externals` and does not match
+ * `externalsExclude`.
+ */
+declare function htmlBundleScriptPlugin(options?: HtmlBundleScriptOptions): Plugin;
+//#endregion
+//#region src/plugins/html-bundle-style/html-bundle-style-plugin.d.ts
+interface HtmlBundleStyleOptions {
+  /**
+   * The HTML attribute name that enables bundling on a link[stylesheet] or style tag.
+   *
+   * @default "bundle"
+   */
+  bundleAttribute?: string;
+}
+declare function htmlBundleStylePlugin(options?: HtmlBundleStyleOptions): Plugin;
+//#endregion
+//#region src/plugins/html-fragment/html-fragment-plugin.d.ts
+interface HtmlFragmentOptions {
+  /**
+   * The tag name used for the fragment custom element.
+   *
+   * @default "fragment"
+   */
+  tagName?: string;
+}
+declare function htmlFragmentPlugin(options?: HtmlFragmentOptions): Plugin;
+//#endregion
+//#region src/plugins/html-iife-script/html-iife-script-plugin.d.ts
+interface HtmlIifeScriptOptions {
+  /**
+   * The attribute name that enables IIFE.
+   *
+   * @default "iife"
+   */
+  iifeAttribute?: string;
+}
+declare function htmlIifeScriptPlugin(options?: HtmlIifeScriptOptions): Plugin;
+//#endregion
+//#region src/plugins/html-inline-script/html-inline-script-plugin.d.ts
+interface HtmlInlineScriptOptions {
+  /**
+   * The attribute name that enables inlining.
+   *
+   * @default "inline"
+   */
+  inlineAttribute?: string;
+}
+declare function htmlInlineScriptPlugin(options?: HtmlInlineScriptOptions): Plugin;
+//#endregion
+//#region src/plugins/html-inline-style/html-inline-style-plugin.d.ts
+interface HtmlInlineStyleOptions {
+  /**
+   * The attribute name that enables inlining.
+   *
+   * @default "inline"
+   */
+  inlineAttribute?: string;
+}
+declare function htmlInlineStylePlugin(options?: HtmlInlineStyleOptions): Plugin;
+//#endregion
+//#region src/plugins/html-inline-svg/html-inline-svg-plugin.d.ts
+interface HtmlInlineSvgOptions {
+  /**
+   * The attribute name that enables inlining.
+   *
+   * @default "inline"
+   */
+  inlineAttribute?: string;
+}
+declare function HtmlInlineSvgPlugin(options?: HtmlInlineSvgOptions): Plugin;
+//#endregion
+//#region src/plugins/html-inline-text/html-inline-text-plugin.d.ts
+interface HtmlInlineTextOptions {
+  /**
+   * The tag name for the inline text.
+   *
+   * @default "inline-text"
+   */
+  tagName?: string;
+  /**
+   * The attribute name on the custom tag that holds the path to the external text file.
+   *
+   * @default "src"
+   */
+  sourceAttribute?: string;
+  /**
+   * The attribute name of the attribute that disables HTML escaping.
+   *
+   * @default "no-escape"
+   */
+  noEscapeAttribute?: string;
+}
+declare function htmlInlineTextPlugin(options?: HtmlInlineTextOptions): Plugin;
+//#endregion
+//#region src/plugins/html-insert/html-insert-plugin.d.ts
+interface HtmlInsertOptions {
+  /**
+   * The HTML tag name of the custom insert element.
+   *
+   * @default "insert"
+   */
+  tagName?: string;
+  /**
+   * The attribute name that points to the target element via a CSS selector.
+   *
+   * @default "selector"
+   */
+  selectorAttribute?: string;
+  /**
+   * The attribute name that enables the replacement of the target element.
+   *
+   * @default "replace"
+   */
+  replaceAttribute?: string;
+  /**
+   * The attribute name that determines the position of the inserted element.
+   *
+   * @default "where"
+   */
+  whereAttribute?: string;
+}
+declare function htmlInsertPlugin(options?: HtmlInsertOptions): Plugin;
+//#endregion
+//#region src/plugins/html-layout/html-layout-plugin.d.ts
+interface HtmlLayoutOptions {
+  /**
+   * Tag names registered as valid HTML elements. Each name is also the required file suffix — e.g. `"layout"` means files must
+   * end in `.layout.html`, `"part"` means `.part.html`.
+   *
+   * @default ["layout", "part"]
+   */
+  tags?: string[];
+  /**
+   * Attribute name used to point to the layout or part file.
+   *
+   * @default "src"
+   */
+  layoutSourceAttribute?: string;
+  /**
+   * Attribute name used to point to an external JSON file whose properties are merged into `$data`. Inline attributes take
+   * priority over file keys.
+   *
+   * @default "dataSource"
+   */
+  dataSourceAttribute?: string;
+  /**
+   * Attribute name used to pass an inline JSON string as data. The value is parsed and merged into `$data` alongside any inline
+   * attributes and any keys loaded via `dataSource`. Inline attributes take priority over `dataJson` keys; `dataJson` keys take
+   * priority over `dataSource` keys.
+   *
+   * @default "data"
+   */
+  dataJsonAttribute?: string;
+  /**
+   * Attribute name that opts a `<script>`, `<style>`, or `<link rel="stylesheet">` tag out of deduplication. By default,
+   * duplicate scripts and styles are removed when a layout or part is used more than once on the same page. Marking a tag with
+   * this boolean attribute forces it to be emitted once per instance.
+   *
+   * @default "always-include"
+   */
+  alwaysIncludeAttribute?: string;
+  /**
+   * Prefix for conditionally adding boolean attributes. Append the target attribute name as a suffix — `add-attr-open`,
+   * `add-attr-disabled`, etc. The value is a JS expression evaluated after placeholder resolution; if it is non-empty and not
+   * `"false"`, the named attribute is added to the element. Multiple `add-attr-*` attributes can appear on the same element.
+   *
+   * ```html
+   * <details add-attr-open="{{ $data.open }}">…</details>
+   * ```
+   *
+   * @default "add-attr"
+   */
+  addAttributeAttribute?: string;
+  /**
+   * Prefix for conditionally removing boolean attributes. Append the target attribute name as a suffix — `remove-attr-disabled`,
+   * `remove-attr-hidden`, etc. The value is a JS expression evaluated after placeholder resolution; if it is non-empty and not
+   * `"false"`, the named attribute is removed from the element. Multiple `remove-attr-*` attributes can appear on the same
+   * element.
+   *
+   * ```html
+   * <button disabled remove-attr-disabled="{{ $data.enabled }}">…</button>
+   * ```
+   *
+   * @default "remove-attr"
+   */
+  removeAttributeAttribute?: string;
+}
+declare function htmlLayoutPlugin(options?: HtmlLayoutOptions): Plugin;
+//#endregion
+//#region src/plugins/html-markdown/html-markdown-plugin.d.ts
+interface HtmlMarkdownOptions {
+  /**
+   * The attribute that when present on a tag will render the content as markdown.
+   *
+   * @default "markdown"
+   */
+  markdownAttribute?: string;
+  /**
+   * The tag name of the element that can reference a markdown file.
+   *
+   * @default "markdown"
+   */
+  tag?: string;
+  /**
+   * The attribute that when present on a tag will render the content as markdown.
+   *
+   * @default "src"
+   */
+  sourceAttribute?: string;
+}
+declare function htmlMarkdownPlugin(options?: HtmlMarkdownOptions): Plugin;
+//#endregion
+//#region src/plugins/html-merge-styles/html-merge-styles-plugin.d.ts
+declare function htmlMergeStylesPlugin(): Plugin;
+//#endregion
+//#region src/plugins/html-pages/html-pages-plugin.d.ts
+interface HtmlPagesOptions {
+  /**
+   * Pages directory relative to the root.
+   *
+   * @default ["pages"]
+   */
+  pagesDir?: string;
+  /**
+   * Where to output the HTML pages relative to the output directory.
+   *
+   * @default "./"
+   */
+  outputDir?: string;
+}
+declare function htmlPagesPlugin(options?: HtmlPagesOptions): Plugin;
+//#endregion
+//#region src/plugins/html-preload/html-preload-plugin.d.ts
+interface HtmlPreloadOptions {
+  /**
+   * Attribute name that enables preloading.
+   *
+   * @default "preload"
+   */
+  preloadAttribute?: string;
+  /**
+   * Attribute name for including files.
+   *
+   * @default "include"
+   */
+  includeAttribute?: string;
+  /**
+   * Attribute name for excluding files.
+   *
+   * @default "exclude"
+   */
+  excludeAttribute?: string;
+}
+declare function htmlPreloadPlugin(options?: HtmlPreloadOptions): Plugin;
+//#endregion
+//#region src/plugins/core-plugins/html-metadata/html-metadata-plugin.d.ts
+interface CoreHtmlPluginOptions {
+  /**
+   * The attribute name to use for minifying script and style tags.
+   *
+   * @default "minify"
+   */
+  minifyAttribute?: string;
+}
+declare function coreHtmlPlugin(options?: CoreHtmlPluginOptions): Plugin;
+//#endregion
+//#region src/plugins/core-plugins/markdown-metadata/markdown-metadata-plugin.d.ts
+interface CoreMarkdownPluginOptions {
+  /**
+   * Remark plugins.
+   *
+   * **Default**:
+   *
+   * 1. `remark-frontmatter`
+   * 2. `remark-gfm`
+   * 3. `remark-smartypants`
+   */
+  remarkPlugins?: Pluggable[];
+  /**
+   * Rehype plugins.
+   *
+   * **Default**:
+   *
+   * 1. `remark-rehype`
+   * 2. `rehype-slug`
+   * 3. `rehype-autolink-headings`
+   * 4. `rehype-external-links`
+   * 5. `rehype-stringify`
+   */
+  rehypePlugins?: Pluggable[];
+  /**
+   * Whether to allow HTML in markdown.
+   *
+   * @default false
+   */
+  allowDangerousHtml?: boolean;
+}
+declare function coreMarkdownPlugin(options?: CoreMarkdownPluginOptions): Plugin;
+//#endregion
+//#region src/plugins/core-plugins/script-metadata/script-metadata-plugin.d.ts
+declare function coreScriptPlugin(): Plugin;
+//#endregion
+//#region src/plugins/core-plugins/style-metadata/style-metadata-plugin.d.ts
+declare function coreStylePlugin(): Plugin;
+//#endregion
+//#region src/plugins/core-plugins/svg-metadata/svg-metadata-plugin.d.ts
+declare function coreSvgPlugin(): Plugin;
+//#endregion
+//#region src/plugins/core-plugins/web-manifest-metadata/web-manifest-metadata-plugin.d.ts
+declare function coreWebManifestPlugin(): Plugin;
+//#endregion
+//#region src/plugins/core-plugins/development-server/development-server-plugin.d.ts
+interface DevelopmentServerOptions {
+  /**
+   * The dev server host.
+   *
+   * @default 0.0.0.0
+   */
+  host?: string;
+  /**
+   * The dev server port.
+   *
+   * @default 3000
+   */
+  port?: number;
+  /**
+   * Entry url pathname when opening the browser.
+   *
+   * @default /
+   */
+  entry?: string;
+}
+declare function developmentServerPlugin(options?: DevelopmentServerOptions): Plugin;
+//#endregion
+//#region src/plugins/cli-plugins/build/build-cli-plugin.d.ts
+interface BuildCliPluginOptions {
+  /**
+   * Build command name.
+   *
+   * @default "build"
+   */
+  command?: string;
+  /**
+   * Build command aliases.
+   *
+   * @default ["b"]
+   */
+  aliases?: string[];
+}
+declare function buildCliPlugin(options?: BuildCliPluginOptions): Plugin;
+//#endregion
+//#region src/plugins/cli-plugins/convert-fonts/convert-fonts-cli-plugin.d.ts
+interface ConvertFontsCliPluginOptions {
+  /**
+   * The name of the command.
+   *
+   * @default "convert-fonts"
+   */
+  command?: string;
+  /**
+   * The aliases of the command.
+   *
+   * @default ["woff2"]
+   */
+  aliases?: string[];
+  /**
+   * The default value of the `--fonts` option.
+   *
+   * A glob pattern to match font files.
+   */
+  fonts?: string;
+  /**
+   * The default value of the `--exclude` option.
+   *
+   * A glob patterns to exclude input files.
+   */
+  exclude?: string;
+  /**
+   * The default value of the `--out-dir` option.
+   *
+   * Where to save the output files.
+   */
+  outDir?: string;
+}
+declare function convertFontsCliPlugin(options?: ConvertFontsCliPluginOptions): Plugin;
+//#endregion
+//#region src/plugins/cli-plugins/generate-font-face/generate-font-face-cli-plugin.d.ts
+interface GenerateFontFacesCliPluginOptions {
+  /**
+   * The name of the command.
+   *
+   * @default "fontface"
+   */
+  command?: string;
+  /**
+   * The aliases of the command.
+   *
+   * @default ["font"]
+   */
+  aliases?: string[];
+  /**
+   * The default value of the `fonts` option.
+   *
+   * A glob pattern to match font files.
+   */
+  fonts?: string;
+  /**
+   * The default value of the `exclude` option.
+   *
+   * A glob patterns to exclude input files.
+   */
+  exclude?: string;
+  /**
+   * The default value of the `cssOut` option.
+   *
+   * Where to save the output CSS file.
+   */
+  cssOut?: string;
+  /**
+   * The default value of the `fontDisplay` option.
+   *
+   * @default "auto"
+   */
+  fontDisplay?: "auto" | "block" | "swap" | "fallback" | "optional";
+}
+declare function generateFontFacesCliPlugin(options?: GenerateFontFacesCliPluginOptions): Plugin;
+//#endregion
+//#region src/plugins/cli-plugins/material-you/material-you/types.d.ts
+type GenerationStyle = "SPRITZ" | "TONAL_SPOT" | "VIBRANT" | "EXPRESSIVE" | "RAINBOW" | "FRUIT_SALAD" | "CONTENT" | "MONOCHROMATIC";
+//#endregion
+//#region src/plugins/cli-plugins/material-you/material-you-cli-plugin.d.ts
+interface MaterialYouCliPluginOptions {
+  /**
+   * Build command name.
+   *
+   * @default "palette"
+   */
+  command?: string;
+  /**
+   * Build command aliases.
+   *
+   * @default ["material-you"]
+   */
+  aliases?: string[];
+  /** The default value for the `--color` option. */
+  color?: string;
+  /**
+   * The default value for the `--style` option.
+   *
+   * @default "TONAL_SPOT"
+   */
+  style?: GenerationStyle;
+  /**
+   * The default value for the `--format` option.
+   *
+   * @default "css"
+   */
+  format?: "css" | "json";
+  /**
+   * The default value for the `--raw` option.
+   *
+   * @default false
+   */
+  raw?: boolean;
+}
+declare function materialYouCliPlugin(options?: MaterialYouCliPluginOptions): Plugin;
+//#endregion
+//#region src/plugins/cli-plugins/serve/serve-cli-plugin.d.ts
+interface ServeCliPluginOptions {
+  /**
+   * Serve command name.
+   *
+   * @default "serve"
+   */
+  command?: string;
+  /**
+   * Serve command aliases.
+   *
+   * @default ["dev"]
+   */
+  aliases?: string[];
+}
+declare function serveCliPlugin(options?: ServeCliPluginOptions): Plugin;
+//#endregion
+export { AnalyzeOutputOptions, BuildCliPluginOptions, BundlePackagesOptions, ConvertFontsCliPluginOptions, ConvertImageOptions, CopyAssetsOptions, CoreHtmlPluginOptions, CoreMarkdownPluginOptions, type CssLinear, CustomEasePluginOptions, DevelopmentServerOptions, GenerateFontFacesCliPluginOptions, HtmlBuildTimeScriptOptions, HtmlBundleScriptOptions, HtmlBundleStyleOptions, HtmlFragmentOptions, HtmlIifeScriptOptions, HtmlInlineScriptOptions, HtmlInlineStyleOptions, HtmlInlineSvgOptions, HtmlInlineSvgPlugin, HtmlInlineTextOptions, HtmlInsertOptions, HtmlLayoutOptions, HtmlMarkdownOptions, HtmlPagesOptions, HtmlPreloadOptions, I18nPluginOptions, ImageFormat, ImagePreset, type ImportAsStringOptions, LoadSourcesPluginOptions, MaterialYouCliPluginOptions, RobotsTextOptions, ServeCliPluginOptions, ServiceWorkerOptions, SitemapOptions, TransformCssOptions, TransformJsPluginOptions, WebManifestOptions, WriteFilesOptions, analyzeOutputPlugin, buildCliPlugin, bundlePackagesPlugin, convertFontsCliPlugin, convertImagePlugin, copyAssetsPlugin, coreHtmlPlugin, coreMarkdownPlugin, coreScriptPlugin, coreStylePlugin, coreSvgPlugin, coreWebManifestPlugin, customEasePlugin, developmentServerPlugin, generateFontFacesCliPlugin, htmlBuildTimeScript, htmlBundleScriptPlugin, htmlBundleStylePlugin, htmlFragmentPlugin, htmlIifeScriptPlugin, htmlInlineScriptPlugin, htmlInlineStylePlugin, htmlInlineTextPlugin, htmlInsertPlugin, htmlLayoutPlugin, htmlMarkdownPlugin, htmlMergeStylesPlugin, htmlPagesPlugin, htmlPreloadPlugin, svgoPlugin as htmlSvgoPlugin, svgoPlugin, i18nPlugin, importAsStringPlugin, type import_as_string, loadSourcesPlugin, materialYouCliPlugin, robotsTextPlugin, serveCliPlugin, serviceWorkerPlugin, sitemapPlugin, svgoOptions, transformCssPlugin, transformJsPlugin, webManifestPlugin, writeFilesPlugin };
+//# sourceMappingURL=index.d.mts.map