prettier-plugin-embed 0.3.1 → 0.4.0

package/README.md

@@ -85,6 +85,10 @@ await prettier.format(code, {
 }
 ```
 
+### Quick Start Config Examples
+
+Here're some [quick start config examples](./ConfigExamples.md) to use this plugin for various embedded languages. Check beblow for a detailed explanation of all the available options.
+
 ### An Overview of the Philosophy
 
 To use this plugin, [`embedded-language-formatting`](https://prettier.io/docs/en/options.html#embedded-language-formatting) option must be set to `auto` (which is the default setting as of now), because this option serves as the main switch for activating embedded language formatting.
@@ -139,6 +143,14 @@ Formatting embedded ECMAScript code doesn't require other plugins and uses the p
 
 Formatting embedded GLSL code requires [`prettier-plugin-glsl`](https://github.com/NaridaL/glsl-language-toolkit/tree/main/packages/prettier-plugin-glsl) to be loaded as well.
 
+#### GraphQL
+
+|            Option            |                   Default                    | Description                                                                                           |
+| :--------------------------: | :------------------------------------------: | ----------------------------------------------------------------------------------------------------- |
+| `embeddedGraphqlIdentifiers` | [`[...]`](./src/embedded/graphql/options.ts) | Tag or comment identifiers that make their subsequent template literals be identified as GraphQL code |
+
+Formatting embedded GraphQL code doesn't require other plugins and uses the parsers and printers provided by Prettier natively. This can override the native embedded language formatting for GraphQL code. If you want to keep the native behavior, set `embeddedGraphqlIdentifiers` to `[]` or other identifiers.
+
 #### HTML
 
 |          Option           |                  Default                  | Description                                                                                        |
@@ -147,6 +159,31 @@ Formatting embedded GLSL code requires [`prettier-plugin-glsl`](https://github.c
 
 Formatting embedded HTML code doesn't require other plugins and uses the parsers and printers provided by Prettier natively. This can override the native embedded language formatting for HTML code.
 
+#### INI
+
+|          Option          |                 Default                  | Description                                                                                       |
+| :----------------------: | :--------------------------------------: | ------------------------------------------------------------------------------------------------- |
+| `embeddedIniIdentifiers` | [`[...]`](./src/embedded/ini/options.ts) | Tag or comment identifiers that make their subsequent template literals be identified as INI code |
+
+Formatting embedded INI code requires [`prettier-plugin-ini`](https://github.com/kddnewton/prettier-plugin-ini) to be loaded as well. And [options](https://github.com/kddnewton/prettier-plugin-ini#configuration) supported by `prettier-plugin-ini` can therefore be used to further control the formatting behavior.
+
+#### JSON
+
+|          Option           |                  Default                   | Description                                                                                        |
+| :-----------------------: | :----------------------------------------: | -------------------------------------------------------------------------------------------------- |
+| `embeddedJsonIdentifiers` | [`[...]`](./src/embedded/json/options.ts)  | Tag or comment identifiers that make their subsequent template literals be identified as JSON code |
+|   `embeddedJsonParser`    | [`"json"`](./src/embedded/json/options.ts) | The parser used to parse the JSON code                                                             |
+
+Formatting embedded JSON code doesn't require other plugins and uses the parsers and printers provided by Prettier natively.
+
+#### LaTeX
+
+|           Option           |                  Default                   | Description                                                                                         |
+| :------------------------: | :----------------------------------------: | --------------------------------------------------------------------------------------------------- |
+| `embeddedLatexIdentifiers` | [`[...]`](./src/embedded/latex/options.ts) | Tag or comment identifiers that make their subsequent template literals be identified as LaTeX code |
+
+Formatting embedded LaTeX code requires [`prettier-plugin-latex`](https://github.com/siefkenj/prettier-plugin-latex) to be loaded as well.
+
 #### Markdown
 
 |            Option             |                    Default                    | Description                                                                                            |
@@ -163,6 +200,14 @@ Formatting embedded Markdown code doesn't require other plugins and uses the par
 
 Formatting embedded PHP code requires [`@prettier/plugin-php`](https://github.com/prettier/plugin-php) to be loaded as well. And [options](https://github.com/prettier/plugin-php#configuration) supported by `@prettier/plugin-php` can therefore be used to further control the formatting behavior.
 
+#### Properties
+
+|             Option              |                     Default                     | Description                                                                                                   |
+| :-----------------------------: | :---------------------------------------------: | ------------------------------------------------------------------------------------------------------------- |
+| `embeddedPropertiesIdentifiers` | [`[...]`](./src/embedded/properties/options.ts) | Tag or comment identifiers that make their subsequent template literals be identified as Java Properties code |
+
+Formatting embedded Java Properties code requires [`prettier-plugin-properties`](https://github.com/eemeli/prettier-plugin-properties) to be loaded as well. And [options](https://github.com/eemeli/prettier-plugin-properties#configuration) supported by `prettier-plugin-properties` can therefore be used to further control the formatting behavior.
+
 #### Ruby
 
 |          Option           |                    Default                    | Description                                                                                                                                        |
@@ -172,15 +217,35 @@ Formatting embedded PHP code requires [`@prettier/plugin-php`](https://github.co
 
 Formatting embedded Ruby code requires [`@prettier/plugin-ruby`](https://github.com/prettier/plugin-ruby) to be loaded and [its dependencies to be installed](https://github.com/prettier/plugin-ruby#getting-started) as well. And [options](https://github.com/prettier/plugin-ruby#configuration) supported by `@prettier/plugin-ruby` can therefore be used to further control the formatting behavior.
 
+#### Shell
+
+|         Option          |                 Default                 | Description                                                                                         |
+| :---------------------: | :-------------------------------------: | --------------------------------------------------------------------------------------------------- |
+| `embeddedShIdentifiers` | [`[...]`](./src/embedded/sh/options.ts) | Tag or comment identifiers that make their subsequent template literals be identified as Shell code |
+
+Formatting embedded Shell code requires [`prettier-plugin-sh`](https://github.com/un-ts/prettier/tree/master/packages/sh#readme) to be loaded as well. And [options](https://github.com/un-ts/prettier/tree/master/packages/sh#parser-options) supported by `prettier-plugin-sh` can therefore be used to further control the formatting behavior.
+
+Note that `prettier-plugin-sh` supports different variants of shell syntaxes and they are specified by the [`variant` option](https://github.com/un-ts/prettier/tree/master/packages/sh#parser-options). To map a subset of identifiers to another dialect, please use [`embeddedOverrides`](#embeddedoverrides).
+
 #### SQL
 
-|          Option          |                 Default                  | Description                                                                                       |
-| :----------------------: | :--------------------------------------: | ------------------------------------------------------------------------------------------------- |
-| `embeddedSqlIdentifiers` | [`[...]`](./src/embedded/sql/options.ts) | Tag or comment identifiers that make their subsequent template literals be identified as SQL code |
+|          Option          |                         Default                          | Description                                                                                                                                 |
+| :----------------------: | :------------------------------------------------------: | ------------------------------------------------------------------------------------------------------------------------------------------- |
+| `embeddedSqlIdentifiers` |         [`[...]`](./src/embedded/sql/options.ts)         | Tag or comment identifiers that make their subsequent template literals be identified as SQL code                                           |
+|   `embeddedSqlPlugin`    | [`"prettier-plugin-sql"`](./src/embedded/sql/options.ts) | The plugin used to format the SQL code. Available options are `"prettier-plugin-sql"` and `"prettier-plugin-sql-cst"`.                      |
+|   `embeddedSqlParser`    |       [`"sqlite"`](./src/embedded/sql/options.ts)        | The parser used to parse the SQL code. Available options are `"sqlite"` and `"bigquery"`. This option is only for `prettier-plugin-sql-cst` |
+
+Formatting embedded SQL code requires [`prettier-plugin-sql`](https://github.com/un-ts/prettier/tree/master/packages/sql#readme) or [`prettier-plugin-sql-cst`](https://github.com/nene/prettier-plugin-sql-cst) to be loaded as well. And [options](https://github.com/un-ts/prettier/tree/master/packages/sql#parser-options) supported by `prettier-plugin-sql`, or [options](https://github.com/nene/prettier-plugin-sql-cst?tab=readme-ov-file#configuration) supported by `prettier-plugin-sql-cst` can therefore be used to further control the formatting behavior.
+
+Note that `prettier-plugin-sql` supports many different SQL dialects and they are specified by the [`language` or `database` option](https://github.com/un-ts/prettier/tree/master/packages/sql#parser-options). And `prettier-plugin-sql-cst` also supports other parsers. To map a subset of identifiers to another dialect or parser, please use [`embeddedOverrides`](#embeddedoverrides).
+
+#### TOML
 
-Formatting embedded SQL code requires [`prettier-plugin-sql`](https://github.com/un-ts/prettier/tree/master/packages/sql#readme) to be loaded as well. And [options](https://github.com/un-ts/prettier/tree/master/packages/sql#parser-options) supported by `prettier-plugin-sql` can therefore be used to further control the formatting behavior.
+|          Option           |                  Default                  | Description                                                                                        |
+| :-----------------------: | :---------------------------------------: | -------------------------------------------------------------------------------------------------- |
+| `embeddedTomlIdentifiers` | [`[...]`](./src/embedded/toml/options.ts) | Tag or comment identifiers that make their subsequent template literals be identified as TOML code |
 
-Note that `prettier-plugin-sql` supports many different SQL dialects and they are specified by the [`language` or `database` option](https://github.com/un-ts/prettier/tree/master/packages/sql#parser-options). To map a subset of identifiers to another dialect, please use [`embeddedOverrides`](#embeddedoverrides).
+Formatting embedded TOML code requires [`prettier-plugin-toml`](https://github.com/un-ts/prettier/tree/master/packages/toml#readme) to be loaded as well. And options supported by `prettier-plugin-toml` can therefore be used to further control the formatting behavior.
 
 #### TS
 
@@ -199,6 +264,14 @@ Formatting embedded TypeScript code doesn't require other plugins and uses the p
 
 Formatting embedded XML code requires [`@prettier/plugin-xml`](https://github.com/prettier/plugin-xml) to be loaded as well. And [options](https://github.com/prettier/plugin-xml#configuration) supported by `@prettier/plugin-xml` can therefore be used to further control the formatting behavior.
 
+#### YAML
+
+|          Option           |                  Default                  | Description                                                                                        |
+| :-----------------------: | :---------------------------------------: | -------------------------------------------------------------------------------------------------- |
+| `embeddedYamlIdentifiers` | [`[...]`](./src/embedded/yaml/options.ts) | Tag or comment identifiers that make their subsequent template literals be identified as YAML code |
+
+Formatting embedded YAML code doesn't require other plugins and uses the parsers and printers provided by Prettier natively.
+
 </details>
 
 ### Language-Agnostic Options
@@ -240,10 +313,6 @@ An example `.json` file is:
 
 Please note that not every option is supported to override. That largely depends on at which phase those options will kick in and take effect. For example, you can't override `tabWidth` in `embeddedOverrides` because this option is used in the [`printDocToString`](https://github.com/prettier/prettier/blob/7aecca5d6473d73f562ca3af874831315f8f2581/src/document/printer.js#L302) phase, where `prettier-plugin-embed` cannot override this option for only a set of specified identifiers. To find the list of unsupported options, please check the interface definition of `EmbeddedOverride` in the [source code](https://github.com/Sec-ant/prettier-plugin-embed/blob/main/src/types.ts).
 
-## Demos
-
-TBD.
-
 ## Contributing
 
 Bug fixes, new language support and tests are welcome. Please have a look at the project structure before getting started. Feel free to leave questions or suggestions.

package/dist/embedded/css/embedder.d.ts

@@ -1,9 +1,12 @@
 import type { Options } from "prettier";
 import type { Embedder } from "../../types.js";
-import { embeddedLanguage } from "./embedded-language.js";
+import { language } from "./language.js";
 export declare const embedder: Embedder<Options>;
+/**
+ * Register the embedder to the EmbeddedEmbedders
+ */
 declare module "../types.js" {
     interface EmbeddedEmbedders {
-        [embeddedLanguage]: typeof embedder;
+        [language]: typeof embedder;
     }
 }

package/dist/embedded/css/index.d.ts

@@ -1,3 +1,3 @@
-export * from "./embedded-language.js";
 export * from "./embedder.js";
+export * from "./language.js";
 export * from "./options.js";

package/dist/embedded/css/language.d.ts

@@ -0,0 +1,9 @@
+export declare const language = "embeddedCss";
+/**
+ * Register the language to the EmbeddedLanguagesHolder
+ */
+declare module "../types.js" {
+    interface EmbeddedLanguagesHolder {
+        [language]: void;
+    }
+}

package/dist/embedded/css/options.d.ts

@@ -1,5 +1,7 @@
 import { type AutocompleteStringList, type StringListToInterfaceKey } from "../utils.js";
-/** References:
+/**
+ * References:
+ *
  * - https://github.com/microsoft/vscode/blob/de0121cf0e05d1673903551b6dbb2871556bfae9/extensions/css/package.json#L22
  * - https://github.com/github-linguist/linguist/blob/7ca3799b8b5f1acde1dd7a8dfb7ae849d3dfb4cd/lib/linguist/languages.yml#L887
  */
@@ -10,14 +12,14 @@ declare const EMBEDDED_LANGUAGE_IDENTIFIERS: "embeddedCssIdentifiers";
 export interface PrettierPluginDepsOptions {
 }
 export declare const options: {
-    embeddedCssIdentifiers: {
-        category: "Global";
-        type: "string";
-        array: true;
-        default: {
-            value: "css"[];
-        }[];
-        description: string;
+    readonly embeddedCssIdentifiers: {
+        readonly category: "Embed";
+        readonly type: "string";
+        readonly array: true;
+        readonly default: [{
+            readonly value: ["css"];
+        }];
+        readonly description: "Specify embedded CSS language identifiers.";
     };
 };
 type Options = typeof options;

package/dist/embedded/es/embedder.d.ts

@@ -1,9 +1,12 @@
 import type { Options } from "prettier";
 import type { Embedder } from "../../types.js";
-import { embeddedLanguage } from "./embedded-language.js";
+import { language } from "./language.js";
 export declare const embedder: Embedder<Options>;
+/**
+ * Register the embedder to the EmbeddedEmbedders
+ */
 declare module "../types.js" {
     interface EmbeddedEmbedders {
-        [embeddedLanguage]: typeof embedder;
+        [language]: typeof embedder;
     }
 }

package/dist/embedded/es/index.d.ts

@@ -1,3 +1,3 @@
-export * from "./embedded-language.js";
 export * from "./embedder.js";
+export * from "./language.js";
 export * from "./options.js";

package/dist/embedded/es/language.d.ts

@@ -0,0 +1,9 @@
+export declare const language = "embeddedEs";
+/**
+ * Register the language to the EmbeddedLanguagesHolder
+ */
+declare module "../types.js" {
+    interface EmbeddedLanguagesHolder {
+        [language]: void;
+    }
+}

package/dist/embedded/es/options.d.ts

@@ -1,33 +1,38 @@
 import { type AutocompleteStringList, type StringListToInterfaceKey } from "../utils.js";
-/** References:
+/**
+ * References:
+ *
  * - https://github.com/microsoft/vscode/blob/de0121cf0e05d1673903551b6dbb2871556bfae9/extensions/javascript/package.json#L37
  * - https://github.com/github-linguist/linguist/blob/7ca3799b8b5f1acde1dd7a8dfb7ae849d3dfb4cd/lib/linguist/languages.yml#L3314
  */
 declare const DEFAULT_IDENTIFIERS: readonly ["js", "jsx", "es", "es6", "mjs", "cjs", "pac", "javascript"];
 type Identifiers = AutocompleteStringList<typeof DEFAULT_IDENTIFIERS>;
 type DefaultIdentifiersHolder = StringListToInterfaceKey<typeof DEFAULT_IDENTIFIERS>;
-declare const DEFAULT_ES_PARSERS: readonly ["babel", "babel-flow", "acorn", "espree", "flow", "meriyah"];
-type EsParser = (typeof DEFAULT_ES_PARSERS)[number];
+declare const ES_PARSERS: readonly ["babel", "babel-flow", "acorn", "espree", "flow", "meriyah"];
+type EsParser = (typeof ES_PARSERS)[number];
 declare const EMBEDDED_LANGUAGE_IDENTIFIERS: "embeddedEsIdentifiers";
 declare const EMBEDDED_LANGUAGE_PARSER: "embeddedEsParser";
 export interface PrettierPluginDepsOptions {
 }
 export declare const options: {
-    embeddedEsIdentifiers: {
-        category: "Global";
-        type: "string";
-        array: true;
-        default: {
-            value: ("js" | "jsx" | "es" | "es6" | "mjs" | "cjs" | "pac" | "javascript")[];
-        }[];
-        description: string;
+    readonly embeddedEsIdentifiers: {
+        readonly category: "Embed";
+        readonly type: "string";
+        readonly array: true;
+        readonly default: [{
+            readonly value: ["js", "jsx", "es", "es6", "mjs", "cjs", "pac", "javascript"];
+        }];
+        readonly description: "Specify embedded ES language identifiers.";
     };
-    embeddedEsParser: {
-        category: "Global";
-        type: "string";
-        array: false;
-        default: string;
+    readonly embeddedEsParser: {
+        category: string;
+        type: "choice";
+        default: "babel";
         description: string;
+        choices: {
+            value: "babel" | "babel-flow" | "acorn" | "espree" | "flow" | "meriyah";
+            description: string;
+        }[];
     };
 };
 type Options = typeof options;

package/dist/embedded/glsl/embedder.d.ts

@@ -1,9 +1,12 @@
 import type { Options } from "prettier";
 import type { Embedder } from "../../types.js";
-import { embeddedLanguage } from "./embedded-language.js";
+import { language } from "./language.js";
 export declare const embedder: Embedder<Options>;
+/**
+ * Register the embedder to the EmbeddedEmbedders
+ */
 declare module "../types.js" {
     interface EmbeddedEmbedders {
-        [embeddedLanguage]: typeof embedder;
+        [language]: typeof embedder;
     }
 }

package/dist/embedded/glsl/index.d.ts

@@ -1,3 +1,3 @@
-export * from "./embedded-language.js";
 export * from "./embedder.js";
+export * from "./language.js";
 export * from "./options.js";

package/dist/embedded/glsl/language.d.ts

@@ -0,0 +1,9 @@
+export declare const language = "embeddedGlsl";
+/**
+ * Register the language to the EmbeddedLanguagesHolder
+ */
+declare module "../types.js" {
+    interface EmbeddedLanguagesHolder {
+        [language]: void;
+    }
+}

package/dist/embedded/glsl/options.d.ts

@@ -1,23 +1,25 @@
 import { type AutocompleteStringList, type StringListToInterfaceKey } from "../utils.js";
-/** References:
+/**
+ * References:
+ *
  * - https://github.com/NaridaL/glsl-language-toolkit/blob/a7bd08d3f31355b335ae002b6a44c2999998b952/packages/prettier-plugin-glsl/src/prettier-plugin.ts#L88
  * - https://github.com/github-linguist/linguist/blob/7ca3799b8b5f1acde1dd7a8dfb7ae849d3dfb4cd/lib/linguist/languages.yml#L2180
  */
-declare const DEFAULT_IDENTIFIERS: readonly ["glsl", "fp", "frag", "frg", "fs", "fsh", "fshader", "geo", "geom", "glslf", "glslv", "gs", "gshader", "rchit", "rmiss", "shader", "tesc", "tese", "vert", "vrx", "vsh", "vshader"];
+declare const DEFAULT_IDENTIFIERS: readonly ["glsl", "shader"];
 type Identifiers = AutocompleteStringList<typeof DEFAULT_IDENTIFIERS>;
 type DefaultIdentifiersHolder = StringListToInterfaceKey<typeof DEFAULT_IDENTIFIERS>;
-declare const embeddedLanguageIdentifiers: "embeddedGlslIdentifiers";
+declare const EMBEDDED_LANGUAGE_IDENTIFIERS: "embeddedGlslIdentifiers";
 export interface PrettierPluginDepsOptions {
 }
 export declare const options: {
-    embeddedGlslIdentifiers: {
-        category: "Global";
-        type: "string";
-        array: true;
-        default: {
-            value: ("glsl" | "fp" | "frag" | "frg" | "fs" | "fsh" | "fshader" | "geo" | "geom" | "glslf" | "glslv" | "gs" | "gshader" | "rchit" | "rmiss" | "shader" | "tesc" | "tese" | "vert" | "vrx" | "vsh" | "vshader")[];
-        }[];
-        description: string;
+    readonly embeddedGlslIdentifiers: {
+        readonly category: "Embed";
+        readonly type: "string";
+        readonly array: true;
+        readonly default: [{
+            readonly value: ["glsl", "shader"];
+        }];
+        readonly description: "Specify embedded GLSL language identifiers. This requires \"prettier-plugin-glsl\".";
     };
 };
 type Options = typeof options;
@@ -27,7 +29,7 @@ declare module "../types.js" {
     interface EmbeddedDefaultIdentifiersHolder extends DefaultIdentifiersHolder {
     }
     interface PrettierPluginEmbedOptions {
-        [embeddedLanguageIdentifiers]?: Identifiers;
+        [EMBEDDED_LANGUAGE_IDENTIFIERS]?: Identifiers;
     }
 }
 declare module "prettier" {

package/dist/embedded/graphql/embedder.d.ts

@@ -0,0 +1,12 @@
+import type { Options } from "prettier";
+import type { Embedder } from "../../types.js";
+import { language } from "./language.js";
+export declare const embedder: Embedder<Options>;
+/**
+ * Register the embedder to the EmbeddedEmbedders
+ */
+declare module "../types.js" {
+    interface EmbeddedEmbedders {
+        [language]: typeof embedder;
+    }
+}

package/dist/embedded/graphql/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./embedder.js";
+export * from "./language.js";
+export * from "./options.js";

package/dist/embedded/graphql/language.d.ts

@@ -0,0 +1,9 @@
+export declare const language = "embeddedGraphql";
+/**
+ * Register the language to the EmbeddedLanguagesHolder
+ */
+declare module "../types.js" {
+    interface EmbeddedLanguagesHolder {
+        [language]: void;
+    }
+}

package/dist/embedded/graphql/options.d.ts

@@ -0,0 +1,38 @@
+import { type AutocompleteStringList, type StringListToInterfaceKey } from "../utils.js";
+/**
+ * References:
+ *
+ * - https://github.com/github-linguist/linguist/blob/7ca3799b8b5f1acde1dd7a8dfb7ae849d3dfb4cd/lib/linguist/languages.yml#L2578
+ */
+declare const DEFAULT_IDENTIFIERS: readonly ["graphql", "gql"];
+type Identifiers = AutocompleteStringList<typeof DEFAULT_IDENTIFIERS>;
+type DefaultIdentifiersHolder = StringListToInterfaceKey<typeof DEFAULT_IDENTIFIERS>;
+declare const EMBEDDED_LANGUAGE_IDENTIFIERS: "embeddedGraphqlIdentifiers";
+export interface PrettierPluginDepsOptions {
+}
+export declare const options: {
+    readonly embeddedGraphqlIdentifiers: {
+        readonly category: "Embed";
+        readonly type: "string";
+        readonly array: true;
+        readonly default: [{
+            readonly value: ["graphql", "gql"];
+        }];
+        readonly description: "Specify embedded GraphQL language identifiers.";
+    };
+};
+type Options = typeof options;
+declare module "../types.js" {
+    interface EmbeddedOptions extends Options {
+    }
+    interface EmbeddedDefaultIdentifiersHolder extends DefaultIdentifiersHolder {
+    }
+    interface PrettierPluginEmbedOptions {
+        [EMBEDDED_LANGUAGE_IDENTIFIERS]?: Identifiers;
+    }
+}
+declare module "prettier" {
+    interface Options extends PrettierPluginDepsOptions {
+    }
+}
+export {};

package/dist/embedded/html/embedder.d.ts

@@ -1,9 +1,12 @@
 import type { Options } from "prettier";
 import type { Embedder } from "../../types.js";
-import { embeddedLanguage } from "./embedded-language.js";
+import { language } from "./language.js";
 export declare const embedder: Embedder<Options>;
+/**
+ * Register the embedder to the EmbeddedEmbedders
+ */
 declare module "../types.js" {
     interface EmbeddedEmbedders {
-        [embeddedLanguage]: typeof embedder;
+        [language]: typeof embedder;
     }
 }

package/dist/embedded/html/index.d.ts

@@ -1,3 +1,3 @@
-export * from "./embedded-language.js";
 export * from "./embedder.js";
+export * from "./language.js";
 export * from "./options.js";

package/dist/embedded/html/language.d.ts

@@ -0,0 +1,9 @@
+export declare const language = "embeddedHtml";
+/**
+ * Register the language to the EmbeddedLanguagesHolder
+ */
+declare module "../types.js" {
+    interface EmbeddedLanguagesHolder {
+        [language]: void;
+    }
+}

package/dist/embedded/html/options.d.ts

@@ -1,23 +1,25 @@
 import { type AutocompleteStringList, type StringListToInterfaceKey } from "../utils.js";
-/** References
+/**
+ * References
+ *
  * - https://github.com/microsoft/vscode/blob/de0121cf0e05d1673903551b6dbb2871556bfae9/extensions/html/package.json#L18
  * - https://github.com/github-linguist/linguist/blob/7ca3799b8b5f1acde1dd7a8dfb7ae849d3dfb4cd/lib/linguist/languages.yml#L2684
  */
-declare const DEFAULT_IDENTIFIERS: readonly ["html", "htm", "shtml", "xhtml", "xht", "mdoc", "jsp", "asp", "aspx", "jshtm", "volt", "rhtml"];
+declare const DEFAULT_IDENTIFIERS: readonly ["html", "xhtml"];
 type Identifiers = AutocompleteStringList<typeof DEFAULT_IDENTIFIERS>;
 type DefaultIdentifiersHolder = StringListToInterfaceKey<typeof DEFAULT_IDENTIFIERS>;
-declare const embeddedLanguageIdentifiers: "embeddedHtmlIdentifiers";
+declare const EMBEDDED_LANGUAGE_IDENTIFIERS: "embeddedHtmlIdentifiers";
 export interface PrettierPluginDepsOptions {
 }
 export declare const options: {
-    embeddedHtmlIdentifiers: {
-        category: "Global";
-        type: "string";
-        array: true;
-        default: {
-            value: ("html" | "htm" | "shtml" | "xhtml" | "xht" | "mdoc" | "jsp" | "asp" | "aspx" | "jshtm" | "volt" | "rhtml")[];
-        }[];
-        description: string;
+    readonly embeddedHtmlIdentifiers: {
+        readonly category: "Embed";
+        readonly type: "string";
+        readonly array: true;
+        readonly default: [{
+            readonly value: ["html", "xhtml"];
+        }];
+        readonly description: "Specify embedded HTML language identifiers.";
     };
 };
 type Options = typeof options;
@@ -27,7 +29,7 @@ declare module "../types.js" {
     interface EmbeddedDefaultIdentifiersHolder extends DefaultIdentifiersHolder {
     }
     interface PrettierPluginEmbedOptions {
-        [embeddedLanguageIdentifiers]?: Identifiers;
+        [EMBEDDED_LANGUAGE_IDENTIFIERS]?: Identifiers;
     }
 }
 declare module "prettier" {

package/dist/embedded/ini/embedder.d.ts

@@ -0,0 +1,12 @@
+import type { Options } from "prettier";
+import type { Embedder } from "../../types.js";
+import { language } from "./language.js";
+export declare const embedder: Embedder<Options>;
+/**
+ * Register the embedder to the EmbeddedEmbedders
+ */
+declare module "../types.js" {
+    interface EmbeddedEmbedders {
+        [language]: typeof embedder;
+    }
+}

package/dist/embedded/ini/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./embedder.js";
+export * from "./language.js";
+export * from "./options.js";

package/dist/embedded/ini/language.d.ts

@@ -0,0 +1,9 @@
+export declare const language = "embeddedIni";
+/**
+ * Register the language to the EmbeddedLanguagesHolder
+ */
+declare module "../types.js" {
+    interface EmbeddedLanguagesHolder {
+        [language]: void;
+    }
+}

package/dist/embedded/ini/options.d.ts

@@ -0,0 +1,39 @@
+import { type AutocompleteStringList, type StringListToInterfaceKey } from "../utils.js";
+/**
+ * References:
+ *
+ * - https://github.com/github-linguist/linguist/blob/7ca3799b8b5f1acde1dd7a8dfb7ae849d3dfb4cd/lib/linguist/languages.yml#L2928
+ */
+declare const DEFAULT_IDENTIFIERS: readonly ["ini", "cfg", "pro"];
+type Identifiers = AutocompleteStringList<typeof DEFAULT_IDENTIFIERS>;
+type DefaultIdentifiersHolder = StringListToInterfaceKey<typeof DEFAULT_IDENTIFIERS>;
+declare const EMBEDDED_LANGUAGE_IDENTIFIERS: "embeddedIniIdentifiers";
+export interface PrettierPluginDepsOptions {
+    iniSpaceAroundEquals?: boolean;
+}
+export declare const options: {
+    readonly embeddedIniIdentifiers: {
+        readonly category: "Embed";
+        readonly type: "string";
+        readonly array: true;
+        readonly default: [{
+            readonly value: ["ini", "cfg", "pro"];
+        }];
+        readonly description: "Specify embedded INI language identifiers. This requires \"prettier-plugin-ini\".";
+    };
+};
+type Options = typeof options;
+declare module "../types.js" {
+    interface EmbeddedOptions extends Options {
+    }
+    interface EmbeddedDefaultIdentifiersHolder extends DefaultIdentifiersHolder {
+    }
+    interface PrettierPluginEmbedOptions {
+        [EMBEDDED_LANGUAGE_IDENTIFIERS]?: Identifiers;
+    }
+}
+declare module "prettier" {
+    interface Options extends PrettierPluginDepsOptions {
+    }
+}
+export {};

package/dist/embedded/json/embedder.d.ts

@@ -0,0 +1,12 @@
+import type { Options } from "prettier";
+import type { Embedder } from "../../types.js";
+import { language } from "./language.js";
+export declare const embedder: Embedder<Options>;
+/**
+ * Register the embedder to the EmbeddedEmbedders
+ */
+declare module "../types.js" {
+    interface EmbeddedEmbedders {
+        [language]: typeof embedder;
+    }
+}

package/dist/embedded/json/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./embedder.js";
+export * from "./language.js";
+export * from "./options.js";

package/dist/embedded/json/language.d.ts

@@ -0,0 +1,9 @@
+export declare const language = "embeddedJson";
+/**
+ * Register the language to the EmbeddedLanguagesHolder
+ */
+declare module "../types.js" {
+    interface EmbeddedLanguagesHolder {
+        [language]: void;
+    }
+}