npm - @cldmv/eslint-plugin-jsonv - Versions diffs - 1.0.12 → 1.0.14 - Mend

@cldmv/eslint-plugin-jsonv 1.0.12 → 1.0.14

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (5) hide show

package/README.md CHANGED Viewed

@@ -8,17 +8,19 @@ ESLint plugin for validating `.jsonv` files using the [@cldmv/jsonv](https://git
 ## ✨ What's New
-### Latest: v1.0.12 (September 2026)
+### Latest: v1.0.13 (September 2026)
-- **A real ESLint AST for `.jsonv` files** — the `jsonv/jsonv` language now builds a positioned AST from `@cldmv/jsonv`'s `parseToAst()` instead of an empty `Program`. Rules can select objects, arrays, properties, literals, references and templates; reports land on the node they target instead of `1:0`; and inline `eslint-disable` / `eslint-enable` / `eslint-disable-next-line` comments now work. Requires `@cldmv/jsonv` 1.1.0 or later (#26).
-- [View full v1.0.12 Changelog](https://github.com/CLDMV/jsonv-eslint-plugin-jsonv/blob/master/docs/changelog/v1/v1.0.12.md)
+- **Published types describe a real ESLint plugin** — `dist/index.d.mts` typed the default export as a bare `Object`; it now types the plugin, the `jsonv/jsonv` language, `JsonvSourceCode` and every AST node against `@eslint/core`'s generics, checked in CI by a new `test:types` script, alongside a declared `engines.node` and `eslint` peer range that finally match what the runtime dependencies require (#30, #37, fixes #28, #32).
+- **Three more language options** — `mode` (`"jsonv"`, `"json5"` or `"json"`), `strictOctal` and `allowInternalReferences` are now accepted, validated and forwarded to `@cldmv/jsonv`, matching what the README already documented (#39, fixes #34).
+- **CLDMV lint/format tooling** — `lint`, `lint:fix`, `format` and `format:check` scripts, a pre-commit hook and the org's shared ESLint/Prettier config land, and the repository is reformatted repo-wide (#38, fixes #33).
+- [View full v1.0.13 Changelog](https://github.com/CLDMV/jsonv-eslint-plugin-jsonv/blob/master/docs/changelog/v1/v1.0.13.md)
 ### Recent Releases
+- **v1.0.12** (September 2026) — the `jsonv/jsonv` language builds a real ESLint AST from `@cldmv/jsonv`'s `parseToAst()`, so rules can select nodes and inline `eslint-disable` comments work (#26) ([Changelog](https://github.com/CLDMV/jsonv-eslint-plugin-jsonv/blob/master/docs/changelog/v1/v1.0.12.md))
 - **v1.0.11** (September 2026) — language options are validated, parse errors report at their real position, and the plugin gained a vitest suite with a CI coverage badge (#16, #17, #18, #23, #24) ([Changelog](https://github.com/CLDMV/jsonv-eslint-plugin-jsonv/blob/master/docs/changelog/v1/v1.0.11.md))
 - **v1.0.10** (September 2026) — the README links back to the jsonv repo (#15) ([Changelog](https://github.com/CLDMV/jsonv-eslint-plugin-jsonv/blob/master/docs/changelog/v1/v1.0.10.md))
 - **v1.0.9** (September 2026) — corrected package name, badge row and license badges (#12) ([Changelog](https://github.com/CLDMV/jsonv-eslint-plugin-jsonv/blob/master/docs/changelog/v1/v1.0.9.md))
-- **v1.0.8** (September 2026) — Node CI matrix updated for vitest 5 (max Node 26, min Node 22.12.0) (#10) ([Changelog](https://github.com/CLDMV/jsonv-eslint-plugin-jsonv/blob/master/docs/changelog/v1/v1.0.8.md))
 📚 **For complete version history, see [docs/changelog/](https://github.com/CLDMV/jsonv-eslint-plugin-jsonv/tree/master/docs/changelog/) and the [GitHub Releases](https://github.com/CLDMV/jsonv-eslint-plugin-jsonv/releases).**
@@ -29,7 +31,7 @@ ESLint plugin for validating `.jsonv` files using the [@cldmv/jsonv](https://git
 - **Internal References**: Validates bare identifiers, template interpolation, nested property access
 - **BigInt Support**: Validates BigInt literals and numeric separators
 - **Accurate Error Reporting**: Parse errors include line/column information
-- **Year-Based Features**: Configurable target ES year for feature detection
+- **Configurable Parsing**: Target ES year, parse mode, strict BigInt and octal checks, and internal reference resolution
 ## Installation
@@ -37,6 +39,8 @@ ESLint plugin for validating `.jsonv` files using the [@cldmv/jsonv](https://git
 npm install --save-dev @cldmv/eslint-plugin-jsonv
 ```
+**Requirements:** Node `^20.19.0 || ^22.13.0 || >=24` and ESLint `^9.13.0 || ^10.0.0` (the first ESLint release with `defaultLanguageOptions` support for plugin `languages`; the plugin's `@eslint/plugin-kit` and `@eslint/core` dependencies also need that Node floor).
 **Note:** This plugin requires `@cldmv/jsonv` as a peer dependency.
 ```bash
@@ -53,6 +57,7 @@ npm run build
 ```
 This will:
 1. Copy `index.mjs` into `dist/index.mjs`
 2. Generate type definitions into `dist/index.d.mts`
 3. Prepare the plugin for use
@@ -62,21 +67,21 @@ This will:
 ### ESLint Flat Config (eslint.config.mjs)
 ```javascript
-import jsonv from '@cldmv/eslint-plugin-jsonv';
+import jsonv from "@cldmv/eslint-plugin-jsonv";
 export default [
-  {
-    files: ["**/*.jsonv"],
-    plugins: { jsonv },
-    language: "jsonv/jsonv",
-    extends: ["jsonv/recommended"]
-  }
+	{
+		files: ["**/*.jsonv"],
+		plugins: { jsonv },
+		language: "jsonv/jsonv",
+		extends: ["jsonv/recommended"]
+	}
 ];
 ```
 ### Configuration Options
-The parser supports the following options:
+`languageOptions` are passed to the `@cldmv/jsonv` parser (both `parseWithOptions()`, which reports errors, and `parseToAst()`, which builds the AST rules see). Every option is optional; the values below are the defaults:
 ```javascript
 {
@@ -84,13 +89,31 @@ The parser supports the following options:
   plugins: { jsonv },
   language: "jsonv/jsonv",
   languageOptions: {
-    year: 2025,           // Target ES year (2011, 2015, 2020, 2021, 2022-2025)
-    strictBigInt: false,  // Require 'n' suffix for large integers
-    mode: "jsonv"         // Parse mode: "jsonv", "json5", "json"
+    year: 2025,                    // Target ES year: which jsonv features are allowed
+    mode: "jsonv",                 // Parse mode: "jsonv", "json5" or "json"
+    strictBigInt: false,           // true: an unsafe integer needs the `n` suffix
+    strictOctal: false,            // true: legacy `0755` octals are errors (use `0o755`)
+    allowInternalReferences: true  // false: references are not resolved or checked
   }
 }
 ```
+| Option                    | Type    | Allowed values                                                                                 | Default   | Meaning                                                                                                                                                                                                                                                                                                                                                           |
+| ------------------------- | ------- | ---------------------------------------------------------------------------------------------- | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `year`                    | number  | `2011`, `2015`, `2016`, `2017`, `2018`, `2019`, `2020`, `2021`, `2022`, `2023`, `2024`, `2025` | `2025`    | The target ES year. A feature introduced after it is an error: binary/octal literals and template literals need 2015, BigInt needs 2020, numeric separators need 2021.                                                                                                                                                                                            |
+| `mode`                    | string  | `"jsonv"`, `"json5"`, `"json"`                                                                 | `"jsonv"` | The parse mode. `"jsonv"` allows every jsonv feature of the selected year, `"json5"` is meant for JSON5 only and `"json"` for strict JSON. The plugin passes the mode through unchanged, so it enforces exactly what `@cldmv/jsonv` enforces: in `@cldmv/jsonv` 1.1.0, `"json"` rejects comments, and the other JSON and JSON5 restrictions are not enforced yet. |
+| `strictBigInt`            | boolean | `true`, `false`                                                                                | `false`   | When `true`, an integer outside the safe range (±9007199254740991) without an `n` suffix is an error. When `false`, it is read as a BigInt.                                                                                                                                                                                                                       |
+| `strictOctal`             | boolean | `true`, `false`                                                                                | `false`   | When `true`, a legacy octal literal such as `0755` is an error; `0o755` is still allowed.                                                                                                                                                                                                                                                                         |
+| `allowInternalReferences` | boolean | `true`, `false`                                                                                | `true`    | When `true`, internal references (`backup: port`, `server.port`, `` `${host}` ``) are resolved, and an undefined or circular reference is an error. When `false`, they are left unresolved and are not reported.                                                                                                                                                  |
+Any other key, or a value outside the allowed ones, is a configuration error (a `TypeError` naming the option).
+Three `@cldmv/jsonv` parse options are deliberately not accepted:
+- `reviver`: a reviver only transforms the evaluated value, and linting does not use that value.
+- `preserveComments`: the AST always carries the comments, so inline `eslint-disable` comments and rules can see them.
+- `tolerant`: the plugin controls how parse errors are collected.
 ### Inline Configuration
 The usual ESLint comments work inside `.jsonv` files: `// eslint-disable`, `/* eslint-disable <rule> */`, `/* eslint-enable */`, `// eslint-disable-line`, `// eslint-disable-next-line`, and `/* eslint <rule>: "off" */` rule configuration.
@@ -99,17 +122,17 @@ The usual ESLint comments work inside `.jsonv` files: `// eslint-disable`, `/* e
 The `jsonv/jsonv` language exposes the document as an AST built from `@cldmv/jsonv`'s `parseToAst()`. Every node has a `loc` (1-based lines and columns) and a `range`, so reports on a node land on that node, and rules can use node types and selectors:
-| Node type | Children | Notes |
-|---|---|---|
-| `Program` | `body` | The document; `body` is the root value. `comments` and `tokens` hang off it. |
-| `ObjectExpression` | `properties` | `{ ... }` |
-| `Property` | `key`, `value` | `key` is a `Literal` (quoted or numeric key) or an `Identifier` (unquoted key). |
-| `ArrayExpression` | `elements` | `[ ... ]` |
-| `Literal` | — | Strings, numbers, BigInt (`bigint` holds the digits), booleans, `null`, `Infinity`, `NaN`; `raw` is the source text. |
-| `Identifier` | — | An unquoted key, or an internal reference such as `backup: port`. |
-| `MemberExpression` | `object`, `property` | A dotted internal reference such as `server.port`. |
-| `TemplateLiteral` | `quasis`, `expressions` | A backtick string with `${...}` interpolation (a plain backtick string is a `Literal`). |
-| `TemplateElement` | — | A literal segment of a template. |
+| Node type          | Children                | Notes                                                                                                                |
+| ------------------ | ----------------------- | -------------------------------------------------------------------------------------------------------------------- |
+| `Program`          | `body`                  | The document; `body` is the root value. `comments` and `tokens` hang off it.                                         |
+| `ObjectExpression` | `properties`            | `{ ... }`                                                                                                            |
+| `Property`         | `key`, `value`          | `key` is a `Literal` (quoted or numeric key) or an `Identifier` (unquoted key).                                      |
+| `ArrayExpression`  | `elements`              | `[ ... ]`                                                                                                            |
+| `Literal`          | —                       | Strings, numbers, BigInt (`bigint` holds the digits), booleans, `null`, `Infinity`, `NaN`; `raw` is the source text. |
+| `Identifier`       | —                       | An unquoted key, or an internal reference such as `backup: port`.                                                    |
+| `MemberExpression` | `object`, `property`    | A dotted internal reference such as `server.port`.                                                                   |
+| `TemplateLiteral`  | `quasis`, `expressions` | A backtick string with `${...}` interpolation (a plain backtick string is a `Literal`).                              |
+| `TemplateElement`  | —                       | A literal segment of a template.                                                                                     |
 ```javascript
 // Report every string value containing "TODO", on the string itself
@@ -127,6 +150,7 @@ create(context) {
 ## Supported Features
 ### ES2011 (JSON5 Base)
 - Single-line (`//`) and multi-line (`/* */`) comments
 - Trailing commas in objects and arrays
 - Unquoted object keys
@@ -139,21 +163,27 @@ create(context) {
 - **Internal references via bare identifiers**: `{ port: 8080, backup: port }`
 ### ES2015 (ES6)
 - Binary literals (`0b1010`)
 - Octal literals (`0o755`, also legacy `0755`)
 - Template literals (backtick strings)
 - **Template interpolation for internal refs**: `` url: `http://${host}:${port}` ``
 ### ES2020
 - BigInt literals (`9007199254740992n`)
 - BigInt in hex/binary/octal formats
 ### ES2021
 - Numeric separators (`1_000_000`, `0xFF_AA`, `0b1111_0000`)
 ## Example
 **config.jsonv:**
+<!-- @cldmv/prettier-plugin-jsonv 1.0.6 rewrites this block destructively (keys become "[object Object]", comments and numeric formats are lost), so prettier leaves it verbatim. -->
+<!-- prettier-ignore -->
 ```jsonv
 {
   // Server configuration with internal references

package/dist/index.d.mts CHANGED Viewed

@@ -1,40 +1,427 @@
 /**
- * @fileoverview ESLint plugin for @cldmv/jsonv files
- * @module eslint-plugin-jsonv
- * @public
- *
- * @description
- * Custom ESLint plugin for validating .jsonv files using the @cldmv/jsonv parser.
- * Provides language definition, parser, and recommended rules for jsonv files.
  *
- * Features:
- * - Validates jsonv syntax using the actual jsonv parser
- * - Reports parse errors with accurate source locations
- * - Supports all ES2011-2025 features (JSON5, binary/octal literals, BigInt, numeric separators, etc.)
- * - Detects internal reference errors (circular refs, undefined refs)
- * - Configurable year-based feature detection
- * - Exposes a positioned AST (objects, arrays, properties, literals, references, templates),
- *   comments and tokens, so rules can select nodes and inline `eslint-disable` comments work
+ *	@Project: @cldmv/eslint-plugin-jsonv
+ *	@Filename: /index.mjs
+ *	@Date: 2026-01-18T20:55:56-08:00 (1768798556)
+ *	@Author: Nate Corcoran <CLDMV>
+ *	@Email: <Shinrai@users.noreply.github.com>
+ *	-----
+ *	@Last modified by: Nate Corcoran <CLDMV> (Shinrai@users.noreply.github.com)
+ *	@Last modified time: 2026-10-02T12:15:39-07:00 (1790968539)
+ *	-----
+ *	@Copyright: Copyright (c) 2013-2026 Catalyzed Motivation Inc. All rights reserved.
  *
- * @example
- * // In eslint.config.mjs
- * import jsonv from 'eslint-plugin-jsonv';
+ */
+import { Directive, TextSourceCodeBase, VisitNodeStep } from "@eslint/plugin-kit";
+import type { FileProblem, Language, OkParseResult, ParseResult, RulesConfig, RuleVisitor, SourceLocation, SourceRange } from "@eslint/core";
+import type { CustomRuleDefinitionType, CustomRuleTypeDefinitions, CustomRuleVisitorWithExit } from "@eslint/plugin-kit";
+import type { TokenType } from "@cldmv/jsonv/parser";
+export type JsonvYear = 2011 | 2015 | 2016 | 2017 | 2018 | 2019 | 2020 | 2021 | 2022 | 2023 | 2024 | 2025;
+export type JsonvMode = "jsonv" | "json5" | "json";
+export type JsonvLanguageOptions = {
+    /**
+     * The ES year whose jsonv features are allowed. Defaults to `2025`.
+     */
+    year?: JsonvYear;
+    /**
+     * The parse mode. Defaults to `"jsonv"`.
+     */
+    mode?: JsonvMode;
+    /**
+     * When `true`, an integer outside the safe range without an `n` suffix is an error instead of
+     * being converted to a BigInt. Defaults to `false`.
+     */
+    strictBigInt?: boolean;
+    /**
+     * When `true`, a legacy octal literal such as `0755` is an error (`0o755` is still allowed).
+     * Defaults to `false`.
+     */
+    strictOctal?: boolean;
+    /**
+     * When `false`, internal references are left unresolved, so an undefined or
+     * circular reference is no longer reported. Defaults to `true`.
+     */
+    allowInternalReferences?: boolean;
+};
+export type JsonvLiteral = {
+    /**
+     * The node type.
+     */
+    type: "Literal";
+    /**
+     * The evaluated value.
+     */
+    value: string | number | bigint | boolean | null;
+    /**
+     * The source text.
+     */
+    raw: string;
+    /**
+     * The BigInt digits, for a BigInt literal.
+     */
+    bigint?: string;
+    /**
+     * The location (1-based lines and columns).
+     */
+    loc: SourceLocation;
+    /**
+     * The `[start, end)` source offsets.
+     */
+    range: SourceRange;
+};
+export type JsonvIdentifier = {
+    /**
+     * The node type.
+     */
+    type: "Identifier";
+    /**
+     * The identifier text.
+     */
+    name: string;
+    /**
+     * The location (1-based lines and columns).
+     */
+    loc: SourceLocation;
+    /**
+     * The `[start, end)` source offsets.
+     */
+    range: SourceRange;
+};
+export type JsonvObjectExpression = {
+    /**
+     * The node type.
+     */
+    type: "ObjectExpression";
+    /**
+     * The properties, in source order.
+     */
+    properties: JsonvProperty[];
+    /**
+     * The location (1-based lines and columns).
+     */
+    loc: SourceLocation;
+    /**
+     * The `[start, end)` source offsets.
+     */
+    range: SourceRange;
+};
+export type JsonvProperty = {
+    /**
+     * The node type.
+     */
+    type: "Property";
+    /**
+     * The key.
+     */
+    key: JsonvLiteral | JsonvIdentifier;
+    /**
+     * The value.
+     */
+    value: JsonvExpression;
+    /**
+     * Always `false` in jsonv.
+     */
+    computed: boolean;
+    /**
+     * The location (1-based lines and columns).
+     */
+    loc: SourceLocation;
+    /**
+     * The `[start, end)` source offsets.
+     */
+    range: SourceRange;
+};
+export type JsonvArrayExpression = {
+    /**
+     * The node type.
+     */
+    type: "ArrayExpression";
+    /**
+     * The elements, in source order.
+     */
+    elements: JsonvExpression[];
+    /**
+     * The location (1-based lines and columns).
+     */
+    loc: SourceLocation;
+    /**
+     * The `[start, end)` source offsets.
+     */
+    range: SourceRange;
+};
+export type JsonvMemberExpression = {
+    /**
+     * The node type.
+     */
+    type: "MemberExpression";
+    /**
+     * The object being accessed.
+     */
+    object: JsonvExpression;
+    /**
+     * The accessed property.
+     */
+    property: JsonvIdentifier;
+    /**
+     * Always `false`.
+     */
+    computed: false;
+    /**
+     * The location (1-based lines and columns).
+     */
+    loc: SourceLocation;
+    /**
+     * The `[start, end)` source offsets.
+     */
+    range: SourceRange;
+};
+export type JsonvTemplateElement = {
+    /**
+     * The node type.
+     */
+    type: "TemplateElement";
+    /**
+     * The raw and cooked segment text.
+     */
+    value: {
+        raw: string;
+        cooked: string;
+    };
+    /**
+     * Whether this is the last segment.
+     */
+    tail: boolean;
+    /**
+     * The location (1-based lines and columns).
+     */
+    loc: SourceLocation;
+    /**
+     * The `[start, end)` source offsets.
+     */
+    range: SourceRange;
+};
+export type JsonvTemplateLiteral = {
+    /**
+     * The node type.
+     */
+    type: "TemplateLiteral";
+    /**
+     * The string segments.
+     */
+    quasis: JsonvTemplateElement[];
+    /**
+     * The interpolated expressions.
+     */
+    expressions: JsonvExpression[];
+    /**
+     * The location (1-based lines and columns).
+     */
+    loc: SourceLocation;
+    /**
+     * The `[start, end)` source offsets.
+     */
+    range: SourceRange;
+};
+export type JsonvExpression = JsonvLiteral | JsonvObjectExpression | JsonvArrayExpression | JsonvIdentifier | JsonvTemplateLiteral | JsonvMemberExpression;
+export type JsonvComment = {
+    /**
+     * The comment kind.
+     */
+    type: "Line" | "Block";
+    /**
+     * The comment text without its delimiters.
+     */
+    value: string;
+    /**
+     * The location (1-based lines and columns).
+     */
+    loc: SourceLocation;
+    /**
+     * The `[start, end)` source offsets.
+     */
+    range: SourceRange;
+};
+export type JsonvToken = {
+    /**
+     * The token type, e.g. `"{"`, `"String"`, `"Identifier"`, `"TemplateHead"`.
+     */
+    type: `${TokenType}`;
+    /**
+     * The token's value.
+     */
+    value: string | number | bigint | boolean | null;
+    /**
+     * The source text.
+     */
+    raw: string;
+    /**
+     * The location (1-based lines and columns).
+     */
+    loc: SourceLocation;
+    /**
+     * The `[start, end)` source offsets.
+     */
+    range: SourceRange;
+};
+export type JsonvProgram = {
+    /**
+     * The node type.
+     */
+    type: "Program";
+    /**
+     * The root value.
+     */
+    body: JsonvExpression;
+    /**
+     * The comments.
+     */
+    comments: JsonvComment[];
+    /**
+     * The tokens, excluding comments.
+     */
+    tokens: JsonvToken[];
+    /**
+     * The location of the whole document (1-based lines and columns).
+     */
+    loc: SourceLocation;
+    /**
+     * The `[start, end)` source offsets of the whole document.
+     */
+    range: SourceRange;
+};
+export type JsonvNode = JsonvProgram | JsonvExpression | JsonvProperty | JsonvTemplateElement;
+export type JsonvSyntaxElement = JsonvNode | JsonvToken | JsonvComment;
+export type JsonvLanguage = Language<{
+    LangOptions: JsonvLanguageOptions;
+    Code: JsonvSourceCode;
+    RootNode: JsonvProgram;
+    Node: JsonvNode;
+}>;
+export type JsonvOkParseResult = OkParseResult<JsonvProgram>;
+export type JsonvParseResult = ParseResult<JsonvProgram>;
+export type JsonvRuleVisitor = RuleVisitor & CustomRuleVisitorWithExit<{
+    Program?: (node: JsonvProgram) => void;
+    ObjectExpression?: (node: JsonvObjectExpression, parent?: JsonvNode) => void;
+    Property?: (node: JsonvProperty, parent?: JsonvObjectExpression) => void;
+    ArrayExpression?: (node: JsonvArrayExpression, parent?: JsonvNode) => void;
+    Literal?: (node: JsonvLiteral, parent?: JsonvNode) => void;
+    Identifier?: (node: JsonvIdentifier, parent?: JsonvNode) => void;
+    MemberExpression?: (node: JsonvMemberExpression, parent?: JsonvNode) => void;
+    TemplateLiteral?: (node: JsonvTemplateLiteral, parent?: JsonvNode) => void;
+    TemplateElement?: (node: JsonvTemplateElement, parent?: JsonvTemplateLiteral) => void;
+}>;
+export type JsonvRuleDefinition<Options extends Partial<CustomRuleTypeDefinitions> = {}> = CustomRuleDefinitionType<{
+    LangOptions: JsonvLanguageOptions;
+    Code: JsonvSourceCode;
+    Visitor: JsonvRuleVisitor;
+    Node: JsonvNode;
+}, Options>;
+/**
+ * SourceCode for a parsed `.jsonv` file, modelled on @eslint/json's `JSONSourceCode`:
+ * positions, lines and text helpers come from `TextSourceCodeBase`; this class adds AST
+ * traversal, parent lookup and inline configuration (`eslint-disable*` / `eslint-enable`
+ * directives and `/* eslint rule: ... *\/` config comments).
  *
- * export default [
- *   {
- *     files: ["**\/*.jsonv"],
- *     plugins: { jsonv },
- *     language: "jsonv/jsonv",
- *     extends: ["jsonv/recommended"]
- *   }
- * ];
+ * @public
+ * @extends {TextSourceCodeBase<{LangOptions: JsonvLanguageOptions, RootNode: JsonvProgram, SyntaxElementWithLoc: JsonvSyntaxElement, ConfigNode: JsonvComment}>}
  */
+declare class JsonvSourceCode extends TextSourceCodeBase<{
+    LangOptions: JsonvLanguageOptions;
+    RootNode: JsonvProgram;
+    SyntaxElementWithLoc: JsonvSyntaxElement;
+    ConfigNode: JsonvComment;
+}> {
+    #private;
+    /** @type {JsonvComment[]} Comments in source order. */
+    comments: JsonvComment[];
+    /** @type {JsonvToken[]} Tokens in source order, excluding comments. */
+    tokens: JsonvToken[];
+    /** @type {boolean} Whether the text starts with a byte order mark. */
+    hasBOM: boolean;
+    /**
+     * Creates a SourceCode object.
+     * @param {Object} options - Options.
+     * @param {string} options.text - The source text.
+     * @param {JsonvProgram} options.ast - The `Program` node built by `jsonvLanguage#parse`.
+     */
+    constructor({ text, ast }: {
+        text: string;
+        ast: JsonvProgram;
+    });
+    /**
+     * Returns the source text split into lines (a fresh copy of `lines`).
+     * @public
+     * @returns {string[]} The lines.
+     */
+    getLines(): string[];
+    /**
+     * Returns the enter/exit visit steps for every node, depth first in source order.
+     * @public
+     * @returns {IterableIterator<VisitNodeStep>} The traversal steps.
+     */
+    traverse(): IterableIterator<VisitNodeStep>;
+    /**
+     * Returns the parent of a node, or `undefined` for the `Program` root.
+     * @public
+     * @param {JsonvSyntaxElement} node - An AST node.
+     * @returns {JsonvNode|undefined} The parent node.
+     */
+    getParent(node: JsonvSyntaxElement): JsonvNode | undefined;
+    /**
+     * Returns the comments that hold inline configuration (`eslint`, `eslint-enable`,
+     * `eslint-disable`, `eslint-disable-line`, `eslint-disable-next-line`).
+     * @public
+     * @returns {JsonvComment[]} The inline configuration comments.
+     */
+    getInlineConfigNodes(): JsonvComment[];
+    /**
+     * Returns the `eslint-disable*` / `eslint-enable` directives, plus problems for malformed
+     * ones (an `eslint-disable-line` spanning several lines).
+     * @public
+     * @returns {{problems: FileProblem[], directives: Directive[]}} Directives and problems.
+     */
+    getDisableDirectives(): {
+        problems: FileProblem[];
+        directives: Directive[];
+    };
+    /**
+     * Returns the rule configurations from `/* eslint rule: ... *\/` comments, plus problems for
+     * ones that fail to parse.
+     * @public
+     * @returns {{problems: FileProblem[], configs: Array<{config: {rules: RulesConfig}, loc: SourceLocation}>}} Configs and problems.
+     */
+    applyInlineConfig(): {
+        problems: FileProblem[];
+        configs: Array<{
+            config: {
+                rules: RulesConfig;
+            };
+            loc: SourceLocation;
+        }>;
+    };
+}
 /**
- * ESLint plugin export
+ * ESLint plugin export. `@satisfies` checks it against @eslint/core's `Plugin` (which ESLint's
+ * own `ESLint.Plugin` is) while keeping its literal keys (`languages.jsonv`, `configs.recommended`).
  *
  * @public
- * @type {Object}
+ * @satisfies {Plugin}
  */
-declare const plugin: Object;
+declare const plugin: {
+    meta: {
+        name: string;
+        version: string;
+    };
+    languages: {
+        jsonv: JsonvLanguage;
+    };
+    configs: {
+        recommended: {
+            rules: {};
+        };
+    };
+    rules: {};
+};
 export default plugin;
+export { JsonvSourceCode };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../index.mjs"],"names":[],"mappings":"AAAA~~;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG~~;~~AAigBH~~;;;;;~~GAKG~~;AACH,QAAA,MAAM,MAAM,~~EAFF~~,~~MAkBT~~,CAAC;eAEa,MAAM"}
1	+ {"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../index.mjs"],"names":[],"mappings":"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"}