@glion/config 0.14.1

package/dist/schema.d.ts

@@ -0,0 +1,292 @@
+import { z } from "zod";
+/**
+ * Schema for hl7v2-specific settings (NOT for plugins/linting).
+ *
+ * This schema defines the `settings` field that can be added to
+ * unified-args configuration files. The `plugins` field is handled
+ * by unified-args and should not be validated here.
+ */
+declare const HL7v2SettingsSchema: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+    /**
+     * Custom delimiters to use as defaults.
+     *
+     * These delimiters serve as fallbacks when:
+     * - Processing non-MSH message fragments
+     * - Working with systems that use non-standard delimiters
+     * - CLI/batch processing where all messages use the same delimiters
+     *
+     * Note: MSH auto-detection will override these if the message starts with
+     * MSH.
+     */
+    delimiters: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+        /**
+         * Component separator character.
+         *
+         * @default "^"
+         */
+        component: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        /**
+         * Escape character.
+         *
+         * @default "\\"
+         */
+        escape: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        /**
+         * Field separator character.
+         *
+         * @default "|"
+         */
+        field: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        /**
+         * Repetition separator character.
+         *
+         * @default "~"
+         */
+        repetition: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        /**
+         * Segment terminator character.
+         *
+         * @default "\\r"
+         */
+        segment: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        /**
+         * Subcomponent separator character.
+         *
+         * @default "&"
+         */
+        subcomponent: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    }, "strict", z.ZodTypeAny, {
+        component: string;
+        escape: string;
+        field: string;
+        repetition: string;
+        segment: string;
+        subcomponent: string;
+    }, {
+        component?: string | undefined;
+        escape?: string | undefined;
+        field?: string | undefined;
+        repetition?: string | undefined;
+        segment?: string | undefined;
+        subcomponent?: string | undefined;
+    }>>>;
+    /**
+     * Experimental features for the parser. These features are subject to
+     * change and may become defaults in future versions.
+     */
+    experimental: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+        /**
+         * Controls how empty fields/components are represented in the AST.
+         *
+         * - 'legacy': Empty fields create full structure (Field → Rep → Comp → Sub
+         *   with value: "")
+         * - 'empty': Empty fields have no children (Field with children: [])
+         *
+         * @default "legacy"
+         */
+        emptyMode: z.ZodDefault<z.ZodEnum<["legacy", "empty"]>>;
+    }, "strict", z.ZodTypeAny, {
+        emptyMode: "legacy" | "empty";
+    }, {
+        emptyMode?: "legacy" | "empty" | undefined;
+    }>>>;
+}, "strict", z.ZodTypeAny, {
+    delimiters: {
+        component: string;
+        escape: string;
+        field: string;
+        repetition: string;
+        segment: string;
+        subcomponent: string;
+    };
+    experimental: {
+        emptyMode: "legacy" | "empty";
+    };
+}, {
+    delimiters?: {
+        component?: string | undefined;
+        escape?: string | undefined;
+        field?: string | undefined;
+        repetition?: string | undefined;
+        segment?: string | undefined;
+        subcomponent?: string | undefined;
+    } | undefined;
+    experimental?: {
+        emptyMode?: "legacy" | "empty" | undefined;
+    } | undefined;
+}>>>;
+export type HL7v2Settings = z.infer<typeof HL7v2SettingsSchema>;
+/**
+ * Full config schema (for documentation/validation).
+ *
+ * Note: The `plugins` field is handled by unified-args.
+ * We document it here but don't deeply validate its structure.
+ */
+export declare const HL7v2ConfigSchema: z.ZodObject<{
+    /**
+     * JSON Schema reference for IDE support. Use:
+     * https://raw.githubusercontent.com/rethinkhealth/hl7v2/main/packages/hl7v2-config/schema.json
+     */
+    $schema: z.ZodOptional<z.ZodString>;
+    /**
+     * Plugins configuration - handled by unified-args.
+     *
+     * Format examples:
+     *
+     * - ["preset-lint-recommended"]
+     * - ["lint-max-message-size", { "maxBytes": 5000000 }]
+     * - ["lint-message-version", ["error", { "expression": ">=2.3 <3.0.0" }]]
+     *
+     * Severity levels: "off" (0), "on"/"warn" (1), "error" (2)
+     */
+    plugins: z.ZodOptional<z.ZodArray<z.ZodAny, "many">>;
+    /**
+     * Hl7v2-specific settings (validated by this package).
+     */
+    settings: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+        /**
+         * Custom delimiters to use as defaults.
+         *
+         * These delimiters serve as fallbacks when:
+         * - Processing non-MSH message fragments
+         * - Working with systems that use non-standard delimiters
+         * - CLI/batch processing where all messages use the same delimiters
+         *
+         * Note: MSH auto-detection will override these if the message starts with
+         * MSH.
+         */
+        delimiters: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+            /**
+             * Component separator character.
+             *
+             * @default "^"
+             */
+            component: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+            /**
+             * Escape character.
+             *
+             * @default "\\"
+             */
+            escape: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+            /**
+             * Field separator character.
+             *
+             * @default "|"
+             */
+            field: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+            /**
+             * Repetition separator character.
+             *
+             * @default "~"
+             */
+            repetition: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+            /**
+             * Segment terminator character.
+             *
+             * @default "\\r"
+             */
+            segment: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+            /**
+             * Subcomponent separator character.
+             *
+             * @default "&"
+             */
+            subcomponent: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        }, "strict", z.ZodTypeAny, {
+            component: string;
+            escape: string;
+            field: string;
+            repetition: string;
+            segment: string;
+            subcomponent: string;
+        }, {
+            component?: string | undefined;
+            escape?: string | undefined;
+            field?: string | undefined;
+            repetition?: string | undefined;
+            segment?: string | undefined;
+            subcomponent?: string | undefined;
+        }>>>;
+        /**
+         * Experimental features for the parser. These features are subject to
+         * change and may become defaults in future versions.
+         */
+        experimental: z.ZodDefault<z.ZodOptional<z.ZodObject<{
+            /**
+             * Controls how empty fields/components are represented in the AST.
+             *
+             * - 'legacy': Empty fields create full structure (Field → Rep → Comp → Sub
+             *   with value: "")
+             * - 'empty': Empty fields have no children (Field with children: [])
+             *
+             * @default "legacy"
+             */
+            emptyMode: z.ZodDefault<z.ZodEnum<["legacy", "empty"]>>;
+        }, "strict", z.ZodTypeAny, {
+            emptyMode: "legacy" | "empty";
+        }, {
+            emptyMode?: "legacy" | "empty" | undefined;
+        }>>>;
+    }, "strict", z.ZodTypeAny, {
+        delimiters: {
+            component: string;
+            escape: string;
+            field: string;
+            repetition: string;
+            segment: string;
+            subcomponent: string;
+        };
+        experimental: {
+            emptyMode: "legacy" | "empty";
+        };
+    }, {
+        delimiters?: {
+            component?: string | undefined;
+            escape?: string | undefined;
+            field?: string | undefined;
+            repetition?: string | undefined;
+            segment?: string | undefined;
+            subcomponent?: string | undefined;
+        } | undefined;
+        experimental?: {
+            emptyMode?: "legacy" | "empty" | undefined;
+        } | undefined;
+    }>>>;
+}, "strip", z.ZodTypeAny, {
+    settings: {
+        delimiters: {
+            component: string;
+            escape: string;
+            field: string;
+            repetition: string;
+            segment: string;
+            subcomponent: string;
+        };
+        experimental: {
+            emptyMode: "legacy" | "empty";
+        };
+    };
+    $schema?: string | undefined;
+    plugins?: any[] | undefined;
+}, {
+    $schema?: string | undefined;
+    plugins?: any[] | undefined;
+    settings?: {
+        delimiters?: {
+            component?: string | undefined;
+            escape?: string | undefined;
+            field?: string | undefined;
+            repetition?: string | undefined;
+            segment?: string | undefined;
+            subcomponent?: string | undefined;
+        } | undefined;
+        experimental?: {
+            emptyMode?: "legacy" | "empty" | undefined;
+        } | undefined;
+    } | undefined;
+}>;
+export type HL7v2Config = z.infer<typeof HL7v2ConfigSchema>;
+/** Input type for config (before defaults are applied) */
+export type HL7v2ConfigInput = z.input<typeof HL7v2ConfigSchema>;
+export {};
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAkHxB;;;;;;GAMG;AACH,QAAA,MAAM,mBAAmB;IAErB;;;;;;;;;;OAUG;;QApHH;;;;WAIG;;QAOH;;;;WAIG;;QAQH;;;;WAIG;;QAOH;;;;WAIG;;QAQH;;;;WAIG;;QAOH;;;;WAIG;;;;;;;;;;;;;;;;;IA0DH;;;OAGG;;QA/CH;;;;;;;;WAQG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA4CO,CAAC;AAEf,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB;IAC5B;;;OAGG;;IAOH;;;;;;;;;;OAUG;;IASH;;OAEG;;QA/DD;;;;;;;;;;WAUG;;YApHH;;;;eAIG;;YAOH;;;;eAIG;;YAQH;;;;eAIG;;YAOH;;;;eAIG;;YAQH;;;;eAIG;;YAOH;;;;eAIG;;;;;;;;;;;;;;;;;QA0DH;;;WAGG;;YA/CH;;;;;;;;eAQG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwFL,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,0DAA0D;AAC1D,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/schema.js

@@ -0,0 +1,51 @@
+import { DEFAULT_DELIMITERS } from "@glion/utils";
+import { z } from "zod";
+//#region src/schema.ts
+/**
+* Schema for delimiter configuration.
+*
+* Each delimiter must be exactly one character. All fields are optional,
+* allowing partial overrides (e.g., only override the field separator).
+*
+* Priority order (lowest to highest):
+*
+* 1. DEFAULT_DELIMITERS (hardcoded in hl7v2-utils)
+* 2. Settings.delimiters (from config file)
+* 3. Opts.delimiters (direct API parameter)
+* 4. MSH auto-detection (if message starts with MSH)
+*/
+const DelimitersSchema = z.object({
+	component: z.string().length(1).optional().default(DEFAULT_DELIMITERS.component).describe("Component separator character"),
+	escape: z.string().length(1).optional().default(DEFAULT_DELIMITERS.escape).describe("Escape character"),
+	field: z.string().length(1).optional().default(DEFAULT_DELIMITERS.field).describe("Field separator character"),
+	repetition: z.string().length(1).optional().default(DEFAULT_DELIMITERS.repetition).describe("Repetition separator character"),
+	segment: z.string().length(1).optional().default(DEFAULT_DELIMITERS.segment).describe("Segment terminator character"),
+	subcomponent: z.string().length(1).optional().default(DEFAULT_DELIMITERS.subcomponent).describe("Subcomponent separator character")
+}).strict().optional().default(DEFAULT_DELIMITERS);
+const ExperimentalSchema = z.object({ emptyMode: z.enum(["legacy", "empty"]).default("legacy").describe("Control how empty values are represented in the parser. 'legacy' creates full structure with empty strings, 'empty' creates empty children arrays.") }).strict().optional().default({ emptyMode: "legacy" });
+/**
+* Schema for hl7v2-specific settings (NOT for plugins/linting).
+*
+* This schema defines the `settings` field that can be added to
+* unified-args configuration files. The `plugins` field is handled
+* by unified-args and should not be validated here.
+*/
+const HL7v2SettingsSchema = z.object({
+	delimiters: DelimitersSchema,
+	experimental: ExperimentalSchema
+}).strict().optional().default({});
+/**
+* Full config schema (for documentation/validation).
+*
+* Note: The `plugins` field is handled by unified-args.
+* We document it here but don't deeply validate its structure.
+*/
+const HL7v2ConfigSchema = z.object({
+	$schema: z.string().url().optional().describe("JSON Schema URL for IDE autocomplete support"),
+	plugins: z.array(z.any()).optional().describe("Plugins configuration - handled by unified-args. Format: [pluginName] or [pluginName, options] or [pluginName, [severity, options]]"),
+	settings: HL7v2SettingsSchema
+});
+//#endregion
+export { HL7v2ConfigSchema };
+
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","names":[],"sources":["../src/schema.ts"],"sourcesContent":["import { DEFAULT_DELIMITERS } from \"@glion/utils\";\nimport { z } from \"zod\";\n\n/**\n * Schema for delimiter configuration.\n *\n * Each delimiter must be exactly one character. All fields are optional,\n * allowing partial overrides (e.g., only override the field separator).\n *\n * Priority order (lowest to highest):\n *\n * 1. DEFAULT_DELIMITERS (hardcoded in hl7v2-utils)\n * 2. Settings.delimiters (from config file)\n * 3. Opts.delimiters (direct API parameter)\n * 4. MSH auto-detection (if message starts with MSH)\n */\nconst DelimitersSchema = z\n  .object({\n    /**\n     * Component separator character.\n     *\n     * @default \"^\"\n     */\n    component: z\n      .string()\n      .length(1)\n      .optional()\n      .default(DEFAULT_DELIMITERS.component)\n      .describe(\"Component separator character\"),\n    /**\n     * Escape character.\n     *\n     * @default \"\\\\\"\n     */\n    escape: z\n      .string()\n      .length(1)\n      .optional()\n      .default(DEFAULT_DELIMITERS.escape)\n      .describe(\"Escape character\"),\n\n    /**\n     * Field separator character.\n     *\n     * @default \"|\"\n     */\n    field: z\n      .string()\n      .length(1)\n      .optional()\n      .default(DEFAULT_DELIMITERS.field)\n      .describe(\"Field separator character\"),\n    /**\n     * Repetition separator character.\n     *\n     * @default \"~\"\n     */\n    repetition: z\n      .string()\n      .length(1)\n      .optional()\n      .default(DEFAULT_DELIMITERS.repetition)\n      .describe(\"Repetition separator character\"),\n\n    /**\n     * Segment terminator character.\n     *\n     * @default \"\\\\r\"\n     */\n    segment: z\n      .string()\n      .length(1)\n      .optional()\n      .default(DEFAULT_DELIMITERS.segment)\n      .describe(\"Segment terminator character\"),\n    /**\n     * Subcomponent separator character.\n     *\n     * @default \"&\"\n     */\n    subcomponent: z\n      .string()\n      .length(1)\n      .optional()\n      .default(DEFAULT_DELIMITERS.subcomponent)\n      .describe(\"Subcomponent separator character\"),\n  })\n  .strict()\n  .optional()\n  .default(DEFAULT_DELIMITERS);\n\nconst ExperimentalSchema = z\n  .object({\n    /**\n     * Controls how empty fields/components are represented in the AST.\n     *\n     * - 'legacy': Empty fields create full structure (Field → Rep → Comp → Sub\n     *   with value: \"\")\n     * - 'empty': Empty fields have no children (Field with children: [])\n     *\n     * @default \"legacy\"\n     */\n    emptyMode: z\n      .enum([\"legacy\", \"empty\"])\n      .default(\"legacy\")\n      .describe(\n        \"Control how empty values are represented in the parser. \" +\n          \"'legacy' creates full structure with empty strings, \" +\n          \"'empty' creates empty children arrays.\"\n      ),\n  })\n  .strict()\n  .optional()\n  .default({ emptyMode: \"legacy\" });\n\n/**\n * Schema for hl7v2-specific settings (NOT for plugins/linting).\n *\n * This schema defines the `settings` field that can be added to\n * unified-args configuration files. The `plugins` field is handled\n * by unified-args and should not be validated here.\n */\nconst HL7v2SettingsSchema = z\n  .object({\n    /**\n     * Custom delimiters to use as defaults.\n     *\n     * These delimiters serve as fallbacks when:\n     * - Processing non-MSH message fragments\n     * - Working with systems that use non-standard delimiters\n     * - CLI/batch processing where all messages use the same delimiters\n     *\n     * Note: MSH auto-detection will override these if the message starts with\n     * MSH.\n     */\n    delimiters: DelimitersSchema,\n\n    /**\n     * Experimental features for the parser. These features are subject to\n     * change and may become defaults in future versions.\n     */\n    experimental: ExperimentalSchema,\n  })\n  .strict()\n  .optional()\n  .default({});\n\nexport type HL7v2Settings = z.infer<typeof HL7v2SettingsSchema>;\n\n/**\n * Full config schema (for documentation/validation).\n *\n * Note: The `plugins` field is handled by unified-args.\n * We document it here but don't deeply validate its structure.\n */\nexport const HL7v2ConfigSchema = z.object({\n  /**\n   * JSON Schema reference for IDE support. Use:\n   * https://raw.githubusercontent.com/rethinkhealth/hl7v2/main/packages/hl7v2-config/schema.json\n   */\n  $schema: z\n    .string()\n    .url()\n    .optional()\n    .describe(\"JSON Schema URL for IDE autocomplete support\"),\n\n  /**\n   * Plugins configuration - handled by unified-args.\n   *\n   * Format examples:\n   *\n   * - [\"preset-lint-recommended\"]\n   * - [\"lint-max-message-size\", { \"maxBytes\": 5000000 }]\n   * - [\"lint-message-version\", [\"error\", { \"expression\": \">=2.3 <3.0.0\" }]]\n   *\n   * Severity levels: \"off\" (0), \"on\"/\"warn\" (1), \"error\" (2)\n   */\n  plugins: z\n    .array(z.any())\n    .optional()\n    .describe(\n      \"Plugins configuration - handled by unified-args. \" +\n        \"Format: [pluginName] or [pluginName, options] or [pluginName, [severity, options]]\"\n    ),\n\n  /**\n   * Hl7v2-specific settings (validated by this package).\n   */\n  settings: HL7v2SettingsSchema,\n});\n\nexport type HL7v2Config = z.infer<typeof HL7v2ConfigSchema>;\n\n/** Input type for config (before defaults are applied) */\nexport type HL7v2ConfigInput = z.input<typeof HL7v2ConfigSchema>;\n"],"mappings":";;;;;;;;;;;;;;;;AAgBA,MAAM,mBAAmB,EACtB,OAAO;CAMN,WAAW,EACR,QAAQ,CACR,OAAO,EAAE,CACT,UAAU,CACV,QAAQ,mBAAmB,UAAU,CACrC,SAAS,gCAAgC;CAM5C,QAAQ,EACL,QAAQ,CACR,OAAO,EAAE,CACT,UAAU,CACV,QAAQ,mBAAmB,OAAO,CAClC,SAAS,mBAAmB;CAO/B,OAAO,EACJ,QAAQ,CACR,OAAO,EAAE,CACT,UAAU,CACV,QAAQ,mBAAmB,MAAM,CACjC,SAAS,4BAA4B;CAMxC,YAAY,EACT,QAAQ,CACR,OAAO,EAAE,CACT,UAAU,CACV,QAAQ,mBAAmB,WAAW,CACtC,SAAS,iCAAiC;CAO7C,SAAS,EACN,QAAQ,CACR,OAAO,EAAE,CACT,UAAU,CACV,QAAQ,mBAAmB,QAAQ,CACnC,SAAS,+BAA+B;CAM3C,cAAc,EACX,QAAQ,CACR,OAAO,EAAE,CACT,UAAU,CACV,QAAQ,mBAAmB,aAAa,CACxC,SAAS,mCAAmC;CAChD,CAAC,CACD,QAAQ,CACR,UAAU,CACV,QAAQ,mBAAmB;AAE9B,MAAM,qBAAqB,EACxB,OAAO,EAUN,WAAW,EACR,KAAK,CAAC,UAAU,QAAQ,CAAC,CACzB,QAAQ,SAAS,CACjB,SACC,qJAGD,EACJ,CAAC,CACD,QAAQ,CACR,UAAU,CACV,QAAQ,EAAE,WAAW,UAAU,CAAC;;;;;;;;AASnC,MAAM,sBAAsB,EACzB,OAAO;CAYN,YAAY;CAMZ,cAAc;CACf,CAAC,CACD,QAAQ,CACR,UAAU,CACV,QAAQ,EAAE,CAAC;;;;;;;AAUd,MAAa,oBAAoB,EAAE,OAAO;CAKxC,SAAS,EACN,QAAQ,CACR,KAAK,CACL,UAAU,CACV,SAAS,+CAA+C;CAa3D,SAAS,EACN,MAAM,EAAE,KAAK,CAAC,CACd,UAAU,CACV,SACC,sIAED;CAKH,UAAU;CACX,CAAC"}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@glion/config",
+  "version": "0.14.1",
+  "description": "Configuration schema and loader for hl7v2",
+  "keywords": [
+    "config",
+    "configuration",
+    "hl7v2",
+    "schema",
+    "settings"
+  ],
+  "homepage": "https://glion.dev",
+  "license": "MIT",
+  "author": {
+    "name": "Melek Somai",
+    "email": "melek@rethinkhealth.io"
+  },
+  "repository": "rethinkhealth/glion.git",
+  "files": [
+    "dist",
+    "schema.json"
+  ],
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js",
+    "./schema.json": "./schema.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "cosmiconfig": "9.0.1",
+    "unified": "11.0.5",
+    "zod": "3.25.76",
+    "@glion/utils": "0.14.1"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "@vitest/coverage-v8": "4.1.2",
+    "tsdown": "0.21.7",
+    "typescript": "^5.9.3",
+    "vitest": "4.1.2",
+    "zod-to-json-schema": "3.25.0",
+    "@glion/tsconfig": "0.0.1",
+    "@glion/testing": "0.0.2"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsdown && tsc --emitDeclarationOnly && pnpm build:schema",
+    "build:schema": "node --input-type=module -e \"import{writeFileSync}from'fs';import{jsonSchema}from'./dist/json-schema.js';writeFileSync('schema.json',JSON.stringify(jsonSchema,null,2));\"",
+    "check-types": "tsc --noEmit",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "test:watch": "vitest"
+  }
+}

package/schema.json

@@ -0,0 +1,99 @@
+{
+  "$ref": "#/definitions/HL7v2Config",
+  "definitions": {
+    "HL7v2Config": {
+      "type": "object",
+      "properties": {
+        "$schema": {
+          "type": "string",
+          "format": "uri",
+          "description": "JSON Schema URL for IDE autocomplete support"
+        },
+        "plugins": {
+          "type": "array",
+          "description": "Plugins configuration - handled by unified-args. Format: [pluginName] or [pluginName, options] or [pluginName, [severity, options]]"
+        },
+        "settings": {
+          "type": "object",
+          "properties": {
+            "delimiters": {
+              "type": "object",
+              "properties": {
+                "component": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 1,
+                  "default": "^",
+                  "description": "Component separator character"
+                },
+                "escape": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 1,
+                  "default": "\\",
+                  "description": "Escape character"
+                },
+                "field": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 1,
+                  "default": "|",
+                  "description": "Field separator character"
+                },
+                "repetition": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 1,
+                  "default": "~",
+                  "description": "Repetition separator character"
+                },
+                "segment": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 1,
+                  "default": "\r",
+                  "description": "Segment terminator character"
+                },
+                "subcomponent": {
+                  "type": "string",
+                  "minLength": 1,
+                  "maxLength": 1,
+                  "default": "&",
+                  "description": "Subcomponent separator character"
+                }
+              },
+              "additionalProperties": false,
+              "default": {
+                "component": "^",
+                "escape": "\\",
+                "field": "|",
+                "repetition": "~",
+                "segment": "\r",
+                "subcomponent": "&"
+              }
+            },
+            "experimental": {
+              "type": "object",
+              "properties": {
+                "emptyMode": {
+                  "type": "string",
+                  "enum": ["legacy", "empty"],
+                  "default": "legacy",
+                  "description": "Control how empty values are represented in the parser. 'legacy' creates full structure with empty strings, 'empty' creates empty children arrays."
+                }
+              },
+              "additionalProperties": false,
+              "default": {
+                "emptyMode": "legacy"
+              }
+            }
+          },
+          "additionalProperties": false,
+          "default": {}
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "$schema": "http://json-schema.org/draft-07/schema#"
+}