@redocly/recheck 0.1.0 → 0.3.0

package/dist/config/presets/prose.js

@@ -0,0 +1,138 @@
+/**
+ * `recheck/prose` — the Vale-parity counterpart to `recheck/markdown`:
+ * `extends: [recheck/markdown, recheck/prose]` is the README-documented
+ * one-liner that replaces a markdownlint + Vale combo with one config.
+ *
+ * A deliberately small, high-signal set, all at `severity: warn` (prose
+ * suggestions, not structural violations):
+ *
+ * - `repetition` — default options, flags an adjacent repeated word.
+ * - `consistency` — internal consistency (first-seen wins) for four common
+ *   British/American variant pairs, with `ignoreCase: true` so a
+ *   sentence-initial "Colour" still counts. Deliberately not a `swap`-style
+ *   fixed-spelling list — `consistency` only requires the file be
+ *   internally consistent, the gentler default.
+ * - `capitalization` — `$sentence`, scoped to `heading` only, with
+ *   `fix: false` (see the `capitalization` rule below). No preset-level
+ *   `exceptions` list: `TECHNICAL_PROPER_NOUNS` (`../../data/proper-nouns.ts`,
+ *   Task 8 of this phase) is unioned in by default by the `capitalization`
+ *   rule itself (rules/scope/capitalization.ts), so the preset inherits the
+ *   built-in vocabulary instead of shipping its own copy — this also
+ *   dissolves the ergonomic wart the Phase 3 version of this list had: a
+ *   user's own `exceptions` on a preset-configured rule *replaces* the
+ *   preset's list (see the README's `extends` merge semantics), so a
+ *   preset-shipped list and built-ins unioned by the rule are not the same
+ *   guarantee — only the latter survives a user override.
+ *
+ * Scope rules have no `defaults.message` to derive a message from (see
+ * markdown.ts's doc comment), so each entry sets its own explicit
+ * `message`, matching the assertion module's own fallback string exactly
+ * so the two never drift apart.
+ *
+ * `occurrence`, `conditional`, `metric`, and `spelling` are documented
+ * opt-ins instead (see the README's "Opt-in prose assertions") — their
+ * thresholds or external peer dependencies are inherently project-specific.
+ * `DOCUMENTED_OPT_IN_ASSERTIONS` (presets/index.ts) is the source of truth
+ * the registry<->preset completeness test (config/__tests__/presets.test.ts)
+ * checks against: every scope-rule assertion must be shipped in some
+ * preset (any preset, not just this one) or be in that list — never
+ * neither, never both.
+ *
+ * `length` used to be a fifth entry here (an opt-in, not a preset default,
+ * because it has no default bounds and requires a `unit` -- see
+ * rules/scope/length.ts). `recheck/google` now ships it directly (see
+ * `google/sentence-length`, spec §5.6's "fewer than 26 words per sentence"
+ * rule), so it moved out of the opt-in list entirely -- see
+ * `DOCUMENTED_OPT_IN_ASSERTIONS`'s own doc comment in presets/index.ts and
+ * cross-task-constraints.md §C / task-9-10-resolutions.md §5 for why.
+ */
+export const PROSE_PRESET_ASSERTIONS = ['repetition', 'consistency', 'capitalization'];
+/**
+ * Shared scope for the preset's `repetition`/`consistency` rules: `summary`
+ * is the canonical all-prose scope — paragraph, heading (all levels),
+ * list-item, blockquote, and table header/body cell text (see
+ * scopes/extractor.ts). Without an explicit scope these would default to
+ * `all` (the whole raw file), and a `--fix` run could rewrite code samples
+ * or frontmatter — "never rewrites code samples" is part of the preset's
+ * README contract; code and frontmatter are not summary sources.
+ */
+const PROSE_SCOPE = 'summary';
+export function buildProsePreset() {
+    const repetition = {
+        severity: 'warn',
+        scope: PROSE_SCOPE,
+        message: 'Repeated word "%s".',
+        assertions: { repetition: {} },
+    };
+    const consistency = {
+        severity: 'warn',
+        scope: PROSE_SCOPE,
+        message: 'Inconsistent spelling: "%s" conflicts with first-seen "%s".',
+        assertions: {
+            consistency: {
+                either: {
+                    behavior: 'behaviour',
+                    color: 'colour',
+                    license: 'licence',
+                    organize: 'organise',
+                },
+                ignoreCase: true,
+            },
+        },
+    };
+    // SENTENCE case, not AP title case (changed from `$title` + `style: 'ap'`
+    // by product decision 2026-07-29: Redocly's own documentation style guide,
+    // this repo's CLAUDE.md, Google's developer documentation style guide, and
+    // Microsoft's writing style guide all mandate sentence case for headings —
+    // AP title case was the outlier).
+    //
+    // No `style` key: applyDollarStyle in rules/scope/capitalization.ts only
+    // reads `style` inside its `$title` branch, so alongside `$sentence` it
+    // would be dead config (the README already documents it as a no-op for
+    // every other `match`).
+    //
+    // `fix: false` (the per-rule auto-fix opt-out the runner honors as
+    // `rule.fix !== false`, see core/runner.ts) even though `capitalization`
+    // is registered `fixable` for the four `$`-styles: a sentence-case
+    // auto-fix lowercases any proper noun the built-in vocabulary (see below)
+    // and the user's own `exceptions` don't cover, so enabling it out of the
+    // box would silently damage content the moment a project's vocabulary
+    // went beyond that. Users turn fixes on (`fix: true`, or just drop this
+    // key) once their exceptions list covers their own vocabulary.
+    //
+    // No `exceptions` key here (Task 8 of this phase; Phase 3 shipped a
+    // 38-entry starter list directly on this rule): `capitalization` itself
+    // now unions `TECHNICAL_PROPER_NOUNS` (../../data/proper-nouns.ts) into
+    // `exceptions` by default (rules/scope/capitalization.ts's `collectSites`),
+    // so this preset inherits that protection instead of shipping its own
+    // copy of the vocabulary — one copy of the list for the whole package,
+    // and it survives a user's own `exceptions` override on this rule key
+    // (which would otherwise REPLACE a preset-shipped list entirely, per the
+    // README's `extends` merge semantics — see proper-nouns.ts's header
+    // comment for why the two are not the same guarantee). Only a handful of
+    // entries don't qualify for the built-in vocabulary's inclusion bar (the
+    // ALL-CAPS `JWT`/`YAML`; `Realm`/`Replay`/`Respect`/`Node`; and, per the
+    // final-review fix wave's audit, `Chrome`/`Markdown`/`Postman`/`Prettier`/
+    // `Safari`/`Swagger`/`Windows` — each a real ordinary English word — see
+    // proper-nouns.ts's header comment for why) and are no longer protected by
+    // this preset by default; ordinary Title-Case brand names like `Redocly`
+    // and `Kubernetes` DO qualify as of the Task 8 fix wave (see
+    // task-8-report.md) and are covered. A project relying on one of the
+    // excluded entries adds it back via its own `exceptions` list on this rule
+    // key, same as any other project-specific vocabulary.
+    const capitalization = {
+        severity: 'warn',
+        scope: 'heading',
+        fix: false,
+        message: '"%s" should use %s capitalization.',
+        assertions: {
+            capitalization: { match: '$sentence' },
+        },
+    };
+    return {
+        'recheck/repetition': repetition,
+        'recheck/consistency': consistency,
+        'recheck/capitalization': capitalization,
+    };
+}
+//# sourceMappingURL=prose.js.map

package/dist/config/presets/prose.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prose.js","sourceRoot":"","sources":["../../../src/config/presets/prose.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,YAAY,EAAE,aAAa,EAAE,gBAAgB,CAAU,CAAC;AAEhG;;;;;;;;GAQG;AACH,MAAM,WAAW,GAAG,SAAS,CAAC;AAE9B,MAAM,UAAU,gBAAgB;IAC9B,MAAM,UAAU,GAAa;QAC3B,QAAQ,EAAE,MAAM;QAChB,KAAK,EAAE,WAAW;QAClB,OAAO,EAAE,qBAAqB;QAC9B,UAAU,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE;KAC/B,CAAC;IAEF,MAAM,WAAW,GAAa;QAC5B,QAAQ,EAAE,MAAM;QAChB,KAAK,EAAE,WAAW;QAClB,OAAO,EAAE,6DAA6D;QACtE,UAAU,EAAE;YACV,WAAW,EAAE;gBACX,MAAM,EAAE;oBACN,QAAQ,EAAE,WAAW;oBACrB,KAAK,EAAE,QAAQ;oBACf,OAAO,EAAE,SAAS;oBAClB,QAAQ,EAAE,UAAU;iBACrB;gBACD,UAAU,EAAE,IAAI;aACjB;SACF;KACF,CAAC;IAEF,0EAA0E;IAC1E,2EAA2E;IAC3E,2EAA2E;IAC3E,2EAA2E;IAC3E,kCAAkC;IAClC,EAAE;IACF,yEAAyE;IACzE,wEAAwE;IACxE,uEAAuE;IACvE,wBAAwB;IACxB,EAAE;IACF,mEAAmE;IACnE,yEAAyE;IACzE,mEAAmE;IACnE,0EAA0E;IAC1E,yEAAyE;IACzE,sEAAsE;IACtE,wEAAwE;IACxE,+DAA+D;IAC/D,EAAE;IACF,oEAAoE;IACpE,wEAAwE;IACxE,wEAAwE;IACxE,4EAA4E;IAC5E,sEAAsE;IACtE,uEAAuE;IACvE,sEAAsE;IACtE,yEAAyE;IACzE,oEAAoE;IACpE,yEAAyE;IACzE,yEAAyE;IACzE,yEAAyE;IACzE,2EAA2E;IAC3E,yEAAyE;IACzE,2EAA2E;IAC3E,yEAAyE;IACzE,6DAA6D;IAC7D,qEAAqE;IACrE,2EAA2E;IAC3E,sDAAsD;IACtD,MAAM,cAAc,GAAa;QAC/B,QAAQ,EAAE,MAAM;QAChB,KAAK,EAAE,SAAS;QAChB,GAAG,EAAE,KAAK;QACV,OAAO,EAAE,oCAAoC;QAC7C,UAAU,EAAE;YACV,cAAc,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE;SACvC;KACF,CAAC;IAEF,OAAO;QACL,oBAAoB,EAAE,UAAU;QAChC,qBAAqB,EAAE,WAAW;QAClC,wBAAwB,EAAE,cAAc;KACzC,CAAC;AACJ,CAAC"}

package/dist/config/schema.d.ts

@@ -1,8 +1,131 @@
+export declare const MARKDOC_TAG_SCHEMA: {
+    type: string;
+    properties: {
+        selfClosing: {
+            type: string;
+        };
+        attributes: {
+            type: string;
+            additionalProperties: {
+                type: string;
+                properties: {
+                    type: {
+                        enum: string[];
+                    };
+                    required: {
+                        type: string;
+                    };
+                    default: {
+                        oneOf: {
+                            type: string;
+                        }[];
+                    };
+                    enum: {
+                        type: string;
+                        items: {
+                            type: string;
+                        };
+                        minItems: number;
+                    };
+                    dynamic: {
+                        type: string;
+                    };
+                };
+                required: string[];
+                additionalProperties: boolean;
+            };
+        };
+    };
+    additionalProperties: boolean;
+};
 export declare const RECHECK_CONFIG_SCHEMA: {
     $schema: string;
     type: string;
+    properties: {
+        extends: {
+            type: string;
+            items: {
+                type: string;
+                minLength: number;
+            };
+        };
+        markdoc: {
+            if: {
+                type: string;
+            };
+            then: {
+                type: string;
+                properties: {
+                    schema: {
+                        enum: (string | boolean)[];
+                    };
+                    extend: {
+                        type: string;
+                        properties: {
+                            tags: {
+                                type: string;
+                                additionalProperties: {
+                                    type: string;
+                                    properties: {
+                                        selfClosing: {
+                                            type: string;
+                                        };
+                                        attributes: {
+                                            type: string;
+                                            additionalProperties: {
+                                                type: string;
+                                                properties: {
+                                                    type: {
+                                                        enum: string[];
+                                                    };
+                                                    required: {
+                                                        type: string;
+                                                    };
+                                                    default: {
+                                                        oneOf: {
+                                                            type: string;
+                                                        }[];
+                                                    };
+                                                    enum: {
+                                                        type: string;
+                                                        items: {
+                                                            type: string;
+                                                        };
+                                                        minItems: number;
+                                                    };
+                                                    dynamic: {
+                                                        type: string;
+                                                    };
+                                                };
+                                                required: string[];
+                                                additionalProperties: boolean;
+                                            };
+                                        };
+                                    };
+                                    additionalProperties: boolean;
+                                };
+                            };
+                            tagsFile: {
+                                type: string;
+                                minLength: number;
+                            };
+                        };
+                        anyOf: {
+                            required: string[];
+                        }[];
+                        additionalProperties: boolean;
+                    };
+                };
+                required: string[];
+                additionalProperties: boolean;
+            };
+            else: {
+                type: string;
+            };
+        };
+    };
     patternProperties: {
-        '^recheck/[a-z0-9-_]+$': {
+        '^[a-z][a-z0-9-]*/[a-z0-9-_]+$': {
             type: string;
             properties: {
                 severity: {
@@ -14,13 +137,8 @@ export declare const RECHECK_CONFIG_SCHEMA: {
                     type: string;
                     minLength: number;
                 };
-                enabled: {
-                    type: string;
-                    default: boolean;
-                };
-                autoFixable: {
+                fix: {
                     type: string;
-                    default: boolean;
                 };
                 tags: {
                     type: string;
@@ -38,29 +156,17 @@ export declare const RECHECK_CONFIG_SCHEMA: {
                 scope: {
                     oneOf: ({
                         type: string;
-                        anyOf: ({
-                            enum: string[];
-                            pattern?: undefined;
-                        } | {
-                            pattern: string;
-                            enum?: undefined;
-                        })[];
+                        minLength: number;
                         items?: undefined;
                         minItems?: undefined;
                     } | {
+                        minLength?: undefined;
                         type: string;
                         items: {
                             type: string;
-                            anyOf: ({
-                                enum: string[];
-                                pattern?: undefined;
-                            } | {
-                                pattern: string;
-                                enum?: undefined;
-                            })[];
+                            minLength: number;
                         };
                         minItems: number;
-                        anyOf?: undefined;
                     })[];
                     default: string;
                 };

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

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqGjC,CAAC"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAwBA,eAAO,MAAM,kBAAkB;IAC7B,IAAI;IACJ,UAAU;QACR,WAAW;YAAI,IAAI;;QACnB,UAAU;YACR,IAAI;YACJ,oBAAoB;;;;wBApBd,IAAI;;;wBACA,IAAI;;;;;;;;wBAMR,IAAI;wBAAW,KAAK;4BAAI,IAAI;;wBAAc,QAAQ;;;wBAC/C,IAAI;;;;;;;;IAejB,oBAAoB;CACrB,CAAC;AAEF,eAAO,MAAM,qBAAqB;;;;;YAS5B,IAAI;YACJ,KAAK;gBAAI,IAAI;gBAAY,SAAS;;;;;gBAkB5B,IAAI;;;;;;wBAII,IAAI;;;;;4BAIV,IAAI;gCAAI,IAAI;gCAAY,oBAAoB;;;wCA7CtD,WAAW;4CAAI,IAAI;;wCACnB,UAAU;4CACR,IAAI;4CACJ,oBAAoB;;;;wDApBd,IAAI;;;wDACA,IAAI;;;;;;;;wDAMR,IAAI;wDAAW,KAAK;4DAAI,IAAI;;wDAAc,QAAQ;;;wDAC/C,IAAI;;;;;;;;;;;4BA2DL,QAAQ;gCAAI,IAAI;gCAAY,SAAS;;;;;;;;;;;;;gBAWrC,IAAI;;;;;;;;;oBAiBR,IAAI;oBACJ,IAAI;oBACJ,OAAO;;;oBAGP,IAAI;oBACJ,SAAS;;;oBAGT,IAAI;;;oBAGJ,IAAI;oBACJ,KAAK;wBACH,IAAI;;;;oBAIN,IAAI;;;oBAGJ,IAAI;oBACJ,MAAM;;;;;;;;;;;;4BAaO,IAAI;4BAAY,SAAS;;;;;;;oBAOtC,IAAI;oBACJ,KAAK;wBACH,IAAI;;;;oBAIN,IAAI;oBACJ,KAAK;wBACH,IAAI;;;;oBAIN,IAAI;oBACJ,UAAU;wBACR,KAAK;4BACH,IAAI;4BACJ,KAAK;gCACH,IAAI;;;wBAGR,KAAK;4BACH,IAAI;4BACJ,KAAK;gCACH,IAAI;;;;oBAIV,oBAAoB;;;oBAGpB,IAAI;oBACJ,oBAAoB;oBACpB,aAAa;;;;;;;;CAQtB,CAAC"}

package/dist/config/schema.js

@@ -1,8 +1,103 @@
+// The object form of the `markdoc` option (schema selection and extension),
+// alongside the boolean shorthand below. Every nested level is
+// `additionalProperties: false` so a misspelled or removed key fails loudly
+// instead of silently doing nothing — the same treatment a rule's own options
+// get. The shape mirrors `MarkdocAttributeSchema`/`MarkdocTagSchema` in
+// parser/markdoc/schema.ts, so a user's `extend.tags` entry is validated
+// exactly like the built-in Realm schema.
+const MARKDOC_ATTRIBUTE_SCHEMA = {
+    type: 'object',
+    properties: {
+        type: { enum: ['string', 'number', 'boolean'] },
+        required: { type: 'boolean' },
+        // `oneOf` of single-type schemas, not a `type: [...]` union array: AJV's
+        // strict mode (on by default -- see the `ajv` instance below) warns
+        // "use allowUnionTypes" on the array form, and this avoids loosening
+        // strict mode globally just for one field.
+        default: { oneOf: [{ type: 'string' }, { type: 'number' }, { type: 'boolean' }] },
+        enum: { type: 'array', items: { type: 'string' }, minItems: 1 },
+        dynamic: { type: 'boolean' },
+    },
+    required: ['type'],
+    additionalProperties: false,
+};
+export const MARKDOC_TAG_SCHEMA = {
+    type: 'object',
+    properties: {
+        selfClosing: { type: 'boolean' },
+        attributes: {
+            type: 'object',
+            additionalProperties: MARKDOC_ATTRIBUTE_SCHEMA,
+        },
+    },
+    additionalProperties: false,
+};
 export const RECHECK_CONFIG_SCHEMA = {
     $schema: 'http://json-schema.org/draft-07/schema#',
     type: 'object',
+    properties: {
+        // Preset names to expand before schema/semantic rule validation runs —
+        // resolved in src/config/validate.ts via resolveExtends() (see
+        // src/config/presets/index.ts). Not a rule; excluded from rule
+        // iteration in validateSemantics().
+        extends: {
+            type: 'array',
+            items: { type: 'string', minLength: 1 },
+        },
+        // Opt-in because Liquid/Jinja share the {% %} delimiters: default-on would
+        // tokenize Jekyll/Hugo template syntax as Markdoc. `true` is shorthand for
+        // `{ schema: 'realm' }` (see parser/markdoc/schema.ts's
+        // resolveMarkdocConfig, which normalizes both forms); `schema: false`
+        // still parses/pairs, just without a schema to validate tags/attributes
+        // against. `extend.tags` layers a project's own custom tags over the
+        // chosen base.
+        //
+        // `if`/`then`/`else` on `type`, not a flat `oneOf: [boolean, object]`. With
+        // `allErrors: true`, AJV collects errors from every failing branch of a
+        // `oneOf`, so an invalid object such as `{ schema: 'bogus' }` also failed
+        // the boolean branch and reported a misleading `/markdoc: must be boolean`
+        // ahead of the real problem. Routing each input shape to exactly one branch
+        // means an object only sees the object-shaped errors, and anything else
+        // only sees `must be boolean`.
+        markdoc: {
+            if: { type: 'object' },
+            then: {
+                type: 'object',
+                properties: {
+                    schema: { enum: ['realm', false] },
+                    extend: {
+                        type: 'object',
+                        properties: {
+                            tags: { type: 'object', additionalProperties: MARKDOC_TAG_SCHEMA },
+                            // Path to a YAML file of tag-name -> tag schema, resolved
+                            // relative to the config file's directory and read by
+                            // config/validate.ts (this module has no filesystem access).
+                            // Inline `tags` above override file entries on collision.
+                            tagsFile: { type: 'string', minLength: 1 },
+                        },
+                        // At least one of the two is required -- an `extend` with neither
+                        // is a no-op the user almost certainly didn't intend.
+                        anyOf: [{ required: ['tags'] }, { required: ['tagsFile'] }],
+                        additionalProperties: false,
+                    },
+                },
+                required: ['schema'],
+                additionalProperties: false,
+            },
+            else: { type: 'boolean' },
+        },
+    },
     patternProperties: {
-        '^recheck/[a-z0-9-_]+$': {
+        // Originally `^recheck/[a-z0-9-_]+$` only, back when every rule key in
+        // every config was `recheck/<name>`. Widened for the style-guide presets,
+        // which namespace each preset's own rule ids by preset name
+        // (`google/no-latinisms`,
+        // `microsoft/use-contractions`, ...) precisely so two flagship presets
+        // can be composed in one config without their rule keys colliding --
+        // `recheck/<name>` remains valid (it's just the `recheck` namespace),
+        // and any other lowercase-alpha-led namespace segment before the `/`
+        // is now accepted too.
+        '^[a-z][a-z0-9-]*/[a-z0-9-_]+$': {
             type: 'object',
             properties: {
                 severity: {
@@ -14,13 +109,8 @@ export const RECHECK_CONFIG_SCHEMA = {
                     type: 'string',
                     minLength: 1,
                 },
-                enabled: {
-                    type: 'boolean',
-                    default: true,
-                },
-                autoFixable: {
+                fix: {
                     type: 'boolean',
-                    default: false,
                 },
                 tags: {
                     type: 'array',
@@ -35,24 +125,18 @@ export const RECHECK_CONFIG_SCHEMA = {
                     type: 'string',
                     format: 'uri',
                 },
+                // Structural shape only (string, or non-empty array of strings).
+                // Term-level vocabulary/selector-syntax validation (the full scope
+                // vocabulary, `~negation`, `&`-conjunction) happens post-schema in
+                // src/config/validate.ts, which can produce a helpful per-term error
+                // message — something AJV's enum/pattern errors can't do well. See
+                // src/scopes/vocabulary.ts for the shared vocabulary list.
                 scope: {
                     oneOf: [
-                        {
-                            type: 'string',
-                            anyOf: [
-                                { enum: ['all', 'heading', 'sentence', 'paragraph', 'code', 'default', 'raw'] },
-                                { pattern: '^heading\\.h[1-6]$' },
-                            ],
-                        },
+                        { type: 'string', minLength: 1 },
                         {
                             type: 'array',
-                            items: {
-                                type: 'string',
-                                anyOf: [
-                                    { enum: ['all', 'heading', 'sentence', 'paragraph', 'code', 'default', 'raw'] },
-                                    { pattern: '^heading\\.h[1-6]$' },
-                                ],
-                            },
+                            items: { type: 'string', minLength: 1 },
                             minItems: 1,
                         },
                     ],

package/dist/config/schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,OAAO,EAAE,yCAAyC;IAClD,IAAI,EAAE,QAAQ;IACd,iBAAiB,EAAE;QACjB,uBAAuB,EAAE;YACvB,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC;oBACtC,OAAO,EAAE,OAAO;iBACjB;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,SAAS,EAAE,CAAC;iBACb;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,SAAS;oBACf,OAAO,EAAE,IAAI;iBACd;gBACD,WAAW,EAAE;oBACX,IAAI,EAAE,SAAS;oBACf,OAAO,EAAE,KAAK;iBACf;gBACD,IAAI,EAAE;oBACJ,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE;wBACL,IAAI,EAAE,QAAQ;qBACf;iBACF;gBACD,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;iBACf;gBACD,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,MAAM,EAAE,KAAK;iBACd;gBACD,KAAK,EAAE;oBACL,KAAK,EAAE;wBACL;4BACE,IAAI,EAAE,QAAQ;4BACd,KAAK,EAAE;gCACL,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC,EAAE;gCAC/E,EAAE,OAAO,EAAE,oBAAoB,EAAE;6BAClC;yBACF;wBACD;4BACE,IAAI,EAAE,OAAO;4BACb,KAAK,EAAE;gCACL,IAAI,EAAE,QAAQ;gCACd,KAAK,EAAE;oCACL,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC,EAAE;oCAC/E,EAAE,OAAO,EAAE,oBAAoB,EAAE;iCAClC;6BACF;4BACD,QAAQ,EAAE,CAAC;yBACZ;qBACF;oBACD,OAAO,EAAE,KAAK;iBACf;gBACD,SAAS,EAAE;oBACT,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE;wBACL,IAAI,EAAE,QAAQ;qBACf;iBACF;gBACD,QAAQ,EAAE;oBACR,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE;wBACL,IAAI,EAAE,QAAQ;qBACf;iBACF;gBACD,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,KAAK,EAAE;4BACL,IAAI,EAAE,OAAO;4BACb,KAAK,EAAE;gCACL,IAAI,EAAE,QAAQ;6BACf;yBACF;wBACD,KAAK,EAAE;4BACL,IAAI,EAAE,OAAO;4BACb,KAAK,EAAE;gCACL,IAAI,EAAE,QAAQ;6BACf;yBACF;qBACF;oBACD,oBAAoB,EAAE,KAAK;iBAC5B;gBACD,UAAU,EAAE;oBACV,IAAI,EAAE,QAAQ;oBACd,oBAAoB,EAAE,IAAI;oBAC1B,aAAa,EAAE,CAAC;iBACjB;aACF;YACD,QAAQ,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,YAAY,CAAC;YAC/C,oBAAoB,EAAE,KAAK;SAC5B;KACF;IACD,oBAAoB,EAAE,KAAK;CAC5B,CAAC"}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"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"}

package/dist/config/validate.d.ts

@@ -1,10 +1,20 @@
 import type { NormalizedRule, ValidationError } from '../types/index.js';
+import type { MarkdocSchema } from '../parser/markdoc/schema.js';
 /**
- * Full validation pipeline
+ * Full validation pipeline. `options.configDir` (default `process.cwd()`) is
+ * where a relative `markdoc.extend.tagsFile` resolves from -- the directory
+ * containing the config file, so a project's `tagsFile: ./tags.yaml` behaves
+ * the same regardless of the caller's own working directory.
  */
-export declare function validate(config: any): Promise<{
+export declare function validate(config: any, options?: {
+    configDir?: string;
+}): Promise<{
     isValid: boolean;
     errors: ValidationError[];
     rules: NormalizedRule[];
+    markdoc: {
+        enabled: boolean;
+        schema: MarkdocSchema | null;
+    };
 }>;
 //# sourceMappingURL=validate.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/config/validate.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAiB,cAAc,EAAE,eAAe,EAAY,MAAM,mBAAmB,CAAC;AA4HlG;;GAEG;AACH,wBAAsB,QAAQ,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC;IACnD,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB,CAAC,CAkBD"}
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/config/validate.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAiB,cAAc,EAAE,eAAe,EAAY,MAAM,mBAAmB,CAAC;AAIlG,OAAO,KAAK,EACV,aAAa,EAId,MAAM,6BAA6B,CAAC;AAg3CrC;;;;;GAKG;AACH,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,GAAG,EACX,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/B,OAAO,CAAC;IACT,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,KAAK,EAAE,cAAc,EAAE,CAAC;IAQxB,OAAO,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAAA;KAAE,CAAC;CAC7D,CAAC,CAqHD"}