@amritk/lint 0.3.3 → 0.4.0

package/AI.md

@@ -0,0 +1,55 @@
+# @amritk/lint — notes for AI coding agents
+
+A fast, format-agnostic JSON/YAML style-guide linter: JSON Schema validation
+plus custom rules, emitting findings with exact `line:column` ranges. Full
+reference is [README.md](./README.md).
+
+> Pre-alpha: APIs change in **minor** versions.
+
+## Minimal example
+
+```ts
+import { lintDocument } from '@amritk/lint'
+
+const ruleset = {
+  rules: {
+    'require-name': { given: '$', severity: 'error', then: { field: 'name', function: 'truthy' } },
+  },
+}
+
+const findings = await lintDocument('version: 1\n', { ruleset, source: 'service.yaml' })
+```
+
+## Gotchas — where agents fail
+
+1. **Two `severity` vocabularies.** In a **ruleset** you author strings
+   (`'error' | 'warn' | 'info' | 'hint' | 'off'`). In a **finding** `severity`
+   is **numeric** (`0` error, `1` warn, `2` info, `3` hint). Don't cross them.
+2. **Ranges are zero-based** (`{ line, character }` from 0). Add 1 to both to
+   print `file:line:col`.
+3. **The engine ships no resolver, no built-in ruleset, no fixers.** `$ref`s are
+   only dereferenced if you pass a `resolve` hook (e.g. wrapping
+   `@amritk/resolve-refs`); `fixDocument` is a no-op until you supply a
+   `FixerRegistry`; `createRuleset()` with no argument runs zero rules.
+4. **`extends` targets are file paths or npm packages only** — there are no
+   named built-in rulesets in core. String `extends` resolve relative to
+   `rulesetBasePath` (or the ruleset file's own directory).
+5. **OpenAPI support is a separate subpath**, `@amritk/lint/rules/openapi`
+   (`createOpenApiRuleset`, `oas`, `oasFixers`, …) — not the package root.
+
+## Exports
+
+- `lintDocument(input, options?)` → findings only.
+- `lintDocumentWithResult(input, options?)` → `{ diagnostics, output?, pluginData }`.
+- `fixDocument(input, options?)` → `{ output, fixed, applied, remaining }` (needs `fixers`).
+- `createRuleset(def?, basePath?)`, `resolveNamedRuleset(name, basePath?)`,
+  `builtinFunctions` (`alphabetical`, `casing`, `truthy`, `pattern`, `schema`, …).
+
+## Subpaths
+
+| Import | Purpose |
+|---|---|
+| `@amritk/lint` | core engine, `lintDocument`/`fixDocument`, built-in functions |
+| `@amritk/lint/rules/openapi` | ready-made OpenAPI preset (`createOpenApiRuleset`, `oas`) |
+
+Install: `bun add @amritk/lint`.

package/dist/core/index.d.ts

@@ -7,5 +7,4 @@ export { type LintPlugin, type LintPluginContext, type LintPluginResult, type Pl
 export { pointerToPath, resolveSourceOrigin, resolveSourceOriginFromMap, resolveSourcePath, } from './pointers.js';
 export { type AliasDefinition, createRuleset, type ExtendModifier, type ExtendResolver, type ResolvedExtend, type Ruleset, type RulesetOptions, } from './ruleset.js';
 export { createLinter, type IRunOptions, type Linter } from './runner.js';
-export * from './types.js';
 export { type IRulesetProblem, validateRuleset } from './validate-ruleset.js';

package/dist/core/index.js

@@ -7,7 +7,6 @@ import { runPlugins } from "./plugin.js";
 import { pointerToPath, resolveSourceOrigin, resolveSourceOriginFromMap, resolveSourcePath } from "./pointers.js";
 import { createRuleset } from "./ruleset.js";
 import { createLinter } from "./runner.js";
-export * from "./types.js";
 import { validateRuleset } from "./validate-ruleset.js";
 export {
   compileQuery,

package/dist/fix/apply.d.ts

@@ -1,4 +1,4 @@
-import type { IDiagnostic } from '../core/index.js';
+import type { IDiagnostic } from '../core/types.js';
 import { type ParserFormat } from '../parsers/index.js';
 import type { FixerRegistry, FixResult } from './types.js';
 /** Options for {@link applyFixes}. */

package/dist/fix/types.d.ts

@@ -1,4 +1,4 @@
-import type { IDiagnostic, JsonPath } from '../core/index.js';
+import type { IDiagnostic, JsonPath } from '../core/types.js';
 import type { EditOp, ParserFormat } from '../parsers/index.js';
 export type { EditOp, ParserFormat };
 /** What a {@link Fixer} is handed for a single finding it might repair. */

package/dist/functions/alphabetical.d.ts

@@ -1,4 +1,4 @@
-import type { RulesetFunction } from '../core/index.js';
+import type { RulesetFunction } from '../core/types.js';
 /** Options for {@link alphabetical}. */
 export type IAlphabeticalOptions = {
     /** Compare objects by this property instead of the value itself. */

package/dist/functions/casing.d.ts

@@ -1,4 +1,4 @@
-import type { RulesetFunction } from '../core/index.js';
+import type { RulesetFunction } from '../core/types.js';
 /** The supported casing styles a value can be checked against. */
 export type CasingType = 'flat' | 'camel' | 'pascal' | 'kebab' | 'cobol' | 'snake' | 'macro';
 /** Options for {@link casing}. */

package/dist/functions/defined.d.ts

@@ -1,3 +1,3 @@
-import type { RulesetFunction } from '../core/index.js';
+import type { RulesetFunction } from '../core/types.js';
 /** Flags a value that is `undefined`. */
 export declare const defined: RulesetFunction;

package/dist/functions/enumeration.d.ts

@@ -1,4 +1,4 @@
-import type { RulesetFunction } from '../core/index.js';
+import type { RulesetFunction } from '../core/types.js';
 /** Options for {@link enumeration}. */
 export type IEnumerationOptions = {
     values: unknown[];

package/dist/functions/falsy.d.ts

@@ -1,3 +1,3 @@
-import type { RulesetFunction } from '../core/index.js';
+import type { RulesetFunction } from '../core/types.js';
 /** Flags a value that is not falsy. */
 export declare const falsy: RulesetFunction;

package/dist/functions/index.d.ts

@@ -1,4 +1,4 @@
-import type { FunctionRegistry } from '../core/index.js';
+import type { FunctionRegistry } from '../core/types.js';
 export { alphabetical, type IAlphabeticalOptions } from './alphabetical.js';
 export { type CasingType, casing, type ICasingOptions } from './casing.js';
 export { defined } from './defined.js';

package/dist/functions/length.d.ts

@@ -1,4 +1,4 @@
-import type { RulesetFunction } from '../core/index.js';
+import type { RulesetFunction } from '../core/types.js';
 /** Options for {@link length}. */
 export type ILengthOptions = {
     min?: number;

package/dist/functions/or.d.ts

@@ -1,4 +1,4 @@
-import type { RulesetFunction } from '../core/index.js';
+import type { RulesetFunction } from '../core/types.js';
 /** Options for {@link or}. */
 export type IOrOptions = {
     properties: string[];

package/dist/functions/pattern.d.ts

@@ -1,4 +1,4 @@
-import type { RulesetFunction } from '../core/index.js';
+import type { RulesetFunction } from '../core/types.js';
 /** Options for {@link pattern}. */
 export type IPatternOptions = {
     match?: string;

package/dist/functions/schema.d.ts

@@ -1,4 +1,4 @@
-import type { RulesetFunction } from '../core/index.js';
+import type { RulesetFunction } from '../core/types.js';
 /** Options for {@link schema}. */
 export type ISchemaOptions = {
     /** The JSON Schema to validate the matched value against. */

package/dist/functions/truthy.d.ts

@@ -1,3 +1,3 @@
-import type { RulesetFunction } from '../core/index.js';
+import type { RulesetFunction } from '../core/types.js';
 /** Flags a value that is not truthy. */
 export declare const truthy: RulesetFunction;

package/dist/functions/typed-enum.d.ts

@@ -1,3 +1,3 @@
-import type { RulesetFunction } from '../core/index.js';
+import type { RulesetFunction } from '../core/types.js';
 /** Validates that each `enum` entry matches the schema's declared `type`. */
 export declare const typedEnum: RulesetFunction<Record<string, unknown>, never>;

package/dist/functions/undefined.d.ts

@@ -1,4 +1,4 @@
-import type { RulesetFunction } from '../core/index.js';
+import type { RulesetFunction } from '../core/types.js';
 /**
  * Flags a value that is defined. Exported as `undefinedFn` because `undefined`
  * is a reserved identifier; it is registered under the name `undefined`.

package/dist/functions/unreferenced-reusable-object.d.ts

@@ -1,4 +1,4 @@
-import type { RulesetFunction } from '../core/index.js';
+import type { RulesetFunction } from '../core/types.js';
 /** Options for {@link unreferencedReusableObject}. */
 export type IUnreferencedReusableObjectOptions = {
     /** JSON pointer to the map of reusable objects, e.g. "#/components/schemas". */

package/dist/functions/xor.d.ts

@@ -1,4 +1,4 @@
-import type { RulesetFunction } from '../core/index.js';
+import type { RulesetFunction } from '../core/types.js';
 /** Options for {@link xor}. */
 export type IXorOptions = {
     properties: string[];

package/dist/index.d.ts

@@ -1,8 +1,9 @@
-import { type IDiagnostic, type IDocumentOptions, type LintPlugin, type LintResolver, type ResolvedExtend, type Ruleset, type RulesetDefinition } from './core/index.js';
+import { type IDocumentOptions, type LintPlugin, type LintResolver, type ResolvedExtend, type Ruleset } from './core/index.js';
+import type { IDiagnostic, RulesetDefinition } from './core/types.js';
 import { type AppliedFix, type FixerRegistry } from './fix/index.js';
-export * from './core/index.js';
-export * from './fix/index.js';
-export * from './functions/index.js';
+export { type AliasDefinition, type CompiledPath, compileQuery, createDocument, createLinter, type Document, detectFormats, type ExtendModifier, type ExtendResolver, type Format, globToRegExp, type IDocumentOptions, type IQueryMatch, type IRulesetProblem, type IRunOptions, type Linter, type LintOptions, type LintPlugin, type LintPluginContext, type LintPluginResult, type LintResolver, type LintResolverResult, type LintResult, lint, lintWithResult, matchesGlob, type PluginRunResult, pointerToPath, query, queryCompiled, queryMany, type ResolvedExtend, type Ruleset, type RulesetOptions, resolveSourceOrigin, resolveSourceOriginFromMap, resolveSourcePath, runPlugins, validateRuleset, } from './core/index.js';
+export { type AppliedFix, type ApplyFixesOptions, applyFixes, createFixPlugin, type EditOp, FIX_PLUGIN_NAME, type FixContext, type Fixer, type FixerRegistry, type FixPluginData, type FixResult, type ParserFormat, } from './fix/index.js';
+export { alphabetical, builtinFunctions, type CasingType, casing, defined, enumeration, falsy, type IAlphabeticalOptions, type ICasingOptions, type IOrOptions, type ISchemaOptions, type IUnreferencedReusableObjectOptions, type IXorOptions, length, or, pattern, schema, truthy, typedEnum, undefinedFn, unreferencedReusableObject, xor, } from './functions/index.js';
 export { detectFormat, parseWithPointers } from './parsers/index.js';
 /**
  * Resolves an `extends` reference to a ruleset definition. Supports:
@@ -53,6 +54,18 @@ export type ILintResult = {
  * Lints a JSON/YAML `input` end to end: parses with source maps and applies the
  * ruleset. Returns just the findings; use {@link lintDocumentWithResult} for the
  * full result.
+ *
+ * @example
+ * ```ts
+ * const ruleset = {
+ *   rules: {
+ *     'require-name': { given: '$', severity: 'error', then: { field: 'name', function: 'truthy' } },
+ *   },
+ * }
+ * const findings = await lintDocument('version: 1\n', { ruleset, source: 'service.yaml' })
+ * // findings[].range is ZERO-based; add 1 to line/character to print file:line:col.
+ * // findings[].severity is numeric (0 error, 1 warn, 2 info, 3 hint).
+ * ```
  */
 export declare const lintDocument: (input: string, options?: ILintOptions) => Promise<IDiagnostic[]>;
 /**

package/dist/index.js

@@ -5,9 +5,9 @@ import { createRuleset as createCoreRuleset, lintWithResult } from "./core/index
 import { createFixPlugin, FIX_PLUGIN_NAME } from "./fix/index.js";
 import { builtinFunctions } from "./functions/index.js";
 import { parseWithPointers } from "./parsers/index.js";
-export * from "./core/index.js";
-export * from "./fix/index.js";
-export * from "./functions/index.js";
+import { compileQuery, createDocument, createLinter, detectFormats, globToRegExp, lint, lintWithResult as lintWithResult2, matchesGlob, pointerToPath, query, queryCompiled, queryMany, resolveSourceOrigin, resolveSourceOriginFromMap, resolveSourcePath, runPlugins, validateRuleset } from "./core/index.js";
+import { applyFixes, createFixPlugin as createFixPlugin2, FIX_PLUGIN_NAME as FIX_PLUGIN_NAME2 } from "./fix/index.js";
+import { alphabetical, builtinFunctions as builtinFunctions2, casing, defined, enumeration, falsy, length, or, pattern, schema, truthy, typedEnum, undefinedFn, unreferencedReusableObject, xor } from "./functions/index.js";
 import { detectFormat, parseWithPointers as parseWithPointers2 } from "./parsers/index.js";
 const require2 = createRequire(import.meta.url);
 const loadRulesetFile = (file) => {
@@ -116,11 +116,46 @@ const fixDocument = async (input, options = {}) => {
   return { output: current, fixed: applied.length > 0, remaining, applied };
 };
 export {
+  FIX_PLUGIN_NAME2 as FIX_PLUGIN_NAME,
+  alphabetical,
+  applyFixes,
+  builtinFunctions2 as builtinFunctions,
+  casing,
+  compileQuery,
+  createDocument,
+  createFixPlugin2 as createFixPlugin,
+  createLinter,
   createRuleset,
+  defined,
   detectFormat,
+  detectFormats,
+  enumeration,
+  falsy,
   fixDocument,
+  globToRegExp,
+  length,
+  lint,
   lintDocument,
   lintDocumentWithResult,
+  lintWithResult2 as lintWithResult,
+  matchesGlob,
+  or,
   parseWithPointers2 as parseWithPointers,
-  resolveNamedRuleset
+  pattern,
+  pointerToPath,
+  query,
+  queryCompiled,
+  queryMany,
+  resolveNamedRuleset,
+  resolveSourceOrigin,
+  resolveSourceOriginFromMap,
+  resolveSourcePath,
+  runPlugins,
+  schema,
+  truthy,
+  typedEnum,
+  undefinedFn,
+  unreferencedReusableObject,
+  validateRuleset,
+  xor
 };

package/dist/parsers/index.d.ts

@@ -1,7 +1,7 @@
 export { type ApplyEditOpsResult, applyEditOps, applyEditOpsWithChanges, type EditOp } from './edit-model.js';
 export { parseJson } from './json.js';
 export { createLineMap, type LineMap } from './lines.js';
-export * from './types.js';
+export { DiagnosticSeverity, type IDiagnostic, type ILocation, type IParseResult, type IParserOptions, type IPosition, type IRange, type JsonPath, } from './types.js';
 export { parseYaml } from './yaml.js';
 import type { IParseResult, IParserOptions } from './types.js';
 /** Which concrete parser a document is routed to. */

package/dist/parsers/index.js

@@ -1,7 +1,7 @@
 import { applyEditOps, applyEditOpsWithChanges } from "./edit-model.js";
 import { parseJson } from "./json.js";
 import { createLineMap } from "./lines.js";
-export * from "./types.js";
+import { DiagnosticSeverity } from "./types.js";
 import { parseYaml } from "./yaml.js";
 import { parseJson as parseJson2 } from "./json.js";
 import { parseYaml as parseYaml2 } from "./yaml.js";
@@ -14,6 +14,7 @@ const parseWithPointers = (source, options = {}) => {
   return format === "json" ? parseJson2(source) : parseYaml2(source, options);
 };
 export {
+  DiagnosticSeverity,
   applyEditOps,
   applyEditOpsWithChanges,
   createLineMap,

package/dist/rules/openapi/functions/example-validation.d.ts

@@ -1,4 +1,4 @@
-import type { RulesetFunction } from '../../../core/index.js';
+import type { RulesetFunction } from '../../../core/types.js';
 /** Options selecting the OpenAPI major version an example rule runs against. */
 export type IOasExampleOptions = {
     /** 2 for OpenAPI 2.0 (Swagger), 3 for OpenAPI 3.x. Defaults to 3. */

package/dist/rules/openapi/functions/index.d.ts

@@ -1,4 +1,4 @@
-import type { FunctionRegistry } from '../../../core/index.js';
+import type { FunctionRegistry } from '../../../core/types.js';
 export { type IOasExampleOptions, oasMediaExample, oasSchemaExample } from './example-validation.js';
 export { oasAdditionalOperations } from './oas-additional-operations.js';
 export { oasDiscriminator } from './oas-discriminator.js';

package/dist/rules/openapi/functions/oas-additional-operations.d.ts

@@ -1,4 +1,4 @@
-import type { RulesetFunction } from '../../../core/index.js';
+import type { RulesetFunction } from '../../../core/types.js';
 /**
  * Flags standard HTTP methods inside an OpenAPI 3.2 `additionalOperations` map.
  * The spec reserves that map for methods without a dedicated fixed field, so a

package/dist/rules/openapi/functions/oas-discriminator.d.ts

@@ -1,3 +1,3 @@
-import type { RulesetFunction } from '../../../core/index.js';
+import type { RulesetFunction } from '../../../core/types.js';
 /** Validates a v2 discriminator references a required property. */
 export declare const oasDiscriminator: RulesetFunction;

package/dist/rules/openapi/functions/oas-example-external-value.d.ts

@@ -1,4 +1,4 @@
-import type { RulesetFunction } from '../../../core/index.js';
+import type { RulesetFunction } from '../../../core/types.js';
 /**
  * Enforces that an Example Object carries exactly one inline value source. Across
  * all of OpenAPI 3.x an Example must use either `value` or `externalValue` (not

package/dist/rules/openapi/functions/oas-example-value.d.ts

@@ -1,3 +1,3 @@
-import type { RulesetFunction } from '../../../core/index.js';
+import type { RulesetFunction } from '../../../core/types.js';
 /** Flags forbidden field combinations on an OpenAPI 3.2 Example Object. */
 export declare const oasExampleValue: RulesetFunction;

package/dist/rules/openapi/functions/oas-mutually-exclusive.d.ts

@@ -1,4 +1,4 @@
-import type { RulesetFunction } from '../../../core/index.js';
+import type { RulesetFunction } from '../../../core/types.js';
 /**
  * Flags objects that carry more than one of a set of mutually exclusive
  * properties. OpenAPI 3.1's License Object, for example, defines `identifier`

package/dist/rules/openapi/functions/oas-no-nullable.d.ts

@@ -1,4 +1,4 @@
-import type { RulesetFunction } from '../../../core/index.js';
+import type { RulesetFunction } from '../../../core/types.js';
 /**
  * Flags a Schema Object's `nullable` keyword, removed in OpenAPI 3.1+ (JSON
  * Schema 2020-12 uses a `"null"` type instead). Targets the *parent* of a

package/dist/rules/openapi/functions/oas-op-form-data-consume-check.d.ts

@@ -1,3 +1,3 @@
-import type { RulesetFunction } from '../../../core/index.js';
+import type { RulesetFunction } from '../../../core/types.js';
 /** Validates OpenAPI v2 formData operations declare a compatible `consumes`. */
 export declare const oasOpFormDataConsumeCheck: RulesetFunction;

package/dist/rules/openapi/functions/oas-op-id-unique.d.ts

@@ -1,3 +1,3 @@
-import type { RulesetFunction } from '../../../core/index.js';
+import type { RulesetFunction } from '../../../core/types.js';
 /** Ensures `operationId` values are unique across the document. */
 export declare const oasOpIdUnique: RulesetFunction;

package/dist/rules/openapi/functions/oas-op-params.d.ts

@@ -1,4 +1,4 @@
-import type { RulesetFunction } from '../../../core/index.js';
+import type { RulesetFunction } from '../../../core/types.js';
 /**
  * Validates an operation's `parameters` array, mirroring Spectral's `oasOpParams`:
  * flags duplicate `name`+`in` combinations, and — for OpenAPI 2.0, where the body

package/dist/rules/openapi/functions/oas-op-security-defined.d.ts

@@ -1,4 +1,4 @@
-import type { RulesetFunction } from '../../../core/index.js';
+import type { RulesetFunction } from '../../../core/types.js';
 /** Validates that every referenced security scheme is defined. */
 export declare const oasOpSecurityDefined: RulesetFunction<Record<string, unknown>, {
     schemesPath: string[];

package/dist/rules/openapi/functions/oas-op-success-response.d.ts

@@ -1,3 +1,3 @@
-import type { RulesetFunction } from '../../../core/index.js';
+import type { RulesetFunction } from '../../../core/types.js';
 /** Ensures every operation declares at least one 2xx or 3xx response. */
 export declare const oasOpSuccessResponse: RulesetFunction;

package/dist/rules/openapi/functions/oas-path-param.d.ts

@@ -1,4 +1,4 @@
-import type { RulesetFunction } from '../../../core/index.js';
+import type { RulesetFunction } from '../../../core/types.js';
 /**
  * Validates path templating per operation, mirroring Spectral's `oasPathParam`.
  * For each operation on a path it checks that (a) every `{template}` in the path

package/dist/rules/openapi/functions/oas-schema-example-deprecated.d.ts

@@ -1,4 +1,4 @@
-import type { RulesetFunction } from '../../../core/index.js';
+import type { RulesetFunction } from '../../../core/types.js';
 /**
  * Flags a Schema Object's singular `example`, deprecated in OpenAPI 3.1 (JSON
  * Schema 2020-12) in favor of the `examples` array. Targets the parent of an

package/dist/rules/openapi/functions/oas-schema.d.ts

@@ -1,4 +1,4 @@
-import type { RulesetFunction } from '../../../core/index.js';
+import type { RulesetFunction } from '../../../core/types.js';
 import { type OasVersion } from '../schemas/index.js';
 /** Options for {@link oasSchema}: which OpenAPI version's meta-schema to validate against. */
 export type IOasSchemaOptions = {

package/dist/rules/openapi/functions/oas-server-name-unique.d.ts

@@ -1,3 +1,3 @@
-import type { RulesetFunction } from '../../../core/index.js';
+import type { RulesetFunction } from '../../../core/types.js';
 /** Flags duplicate OpenAPI 3.2 Server Object `name` values across the servers array. */
 export declare const oasServerNameUnique: RulesetFunction;

package/dist/rules/openapi/functions/oas-server-variables.d.ts

@@ -1,4 +1,4 @@
-import type { RulesetFunction } from '../../../core/index.js';
+import type { RulesetFunction } from '../../../core/types.js';
 /**
  * Validates a Server Object's `variables`, mirroring Spectral's `serverVariables`:
  * every `{template}` in the URL must have a matching variable and vice versa, and

package/dist/rules/openapi/functions/oas-tag-defined.d.ts

@@ -1,3 +1,3 @@
-import type { RulesetFunction } from '../../../core/index.js';
+import type { RulesetFunction } from '../../../core/types.js';
 /** Ensures each operation tag is declared in the global `tags` list. */
 export declare const oasTagDefined: RulesetFunction;

package/dist/rules/openapi/functions/oas-tag-kind.d.ts

@@ -1,3 +1,3 @@
-import type { RulesetFunction } from '../../../core/index.js';
+import type { RulesetFunction } from '../../../core/types.js';
 /** Flags a present-but-unregistered OpenAPI 3.2 Tag Object `kind` value. */
 export declare const oasTagKind: RulesetFunction;

package/dist/rules/openapi/functions/oas-tag-parent-defined.d.ts

@@ -1,4 +1,4 @@
-import type { RulesetFunction } from '../../../core/index.js';
+import type { RulesetFunction } from '../../../core/types.js';
 /**
  * Validates the OpenAPI 3.2 Tag Object `parent` hierarchy: every `parent` must
  * name a tag that exists in the top-level `tags` list, a tag must not be its own

package/dist/rules/openapi/functions/oas-tags-unique.d.ts

@@ -1,3 +1,3 @@
-import type { RulesetFunction } from '../../../core/index.js';
+import type { RulesetFunction } from '../../../core/types.js';
 /** Flags duplicate global tag names. */
 export declare const oasTagsUnique: RulesetFunction;

package/dist/rules/openapi/functions/oas-unused-component.d.ts

@@ -1,4 +1,4 @@
-import type { RulesetFunction } from '../../../core/index.js';
+import type { RulesetFunction } from '../../../core/types.js';
 /**
  * Flags reusable `components/*` entries that nothing `$ref`s. Spectral's
  * `oas3-unused-component` checks every reusable component type (not just

package/dist/rules/openapi/functions/ref-siblings.d.ts

@@ -1,3 +1,3 @@
-import type { RulesetFunction } from '../../../core/index.js';
+import type { RulesetFunction } from '../../../core/types.js';
 /** Flags objects that mix `$ref` with sibling keys (which are ignored per spec). */
 export declare const refSiblings: RulesetFunction;

package/dist/rules/openapi/index.d.ts

@@ -1,4 +1,5 @@
-import { type FunctionRegistry, type ResolvedExtend, type Ruleset, type RulesetDefinition } from '../../core/index.js';
+import { type ResolvedExtend, type Ruleset } from '../../core/index.js';
+import type { FunctionRegistry, RulesetDefinition } from '../../core/types.js';
 export { oasFixers } from './fixers.js';
 export { oas2, oas3, oas3_0, oas3_1, oas3_2, oasFormats } from './formats.js';
 export { oasFunctions } from './functions/index.js';

package/dist/rules/openapi/oas.d.ts

@@ -1,3 +1,3 @@
-import type { RulesetDefinition } from '../../core/index.js';
+import type { RulesetDefinition } from '../../core/types.js';
 /** Loupe's built-in OpenAPI ruleset (`loupe:oas`). */
 export declare const oas: RulesetDefinition;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amritk/lint",
-  "version": "0.3.3",
+  "version": "0.4.0",
   "description": "A fast, format-agnostic JSON/YAML style-guide linter with JSON Schema and custom rules.",
   "module": "./dist/index.js",
   "type": "module",
@@ -27,7 +27,8 @@
     "url": "https://github.com/amritk/mjst/issues"
   },
   "files": [
-    "dist"
+    "dist",
+    "AI.md"
   ],
   "publishConfig": {
     "access": "public"
@@ -45,18 +46,22 @@
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
     },
+    "./types": {
+      "types": "./dist/core/types.d.ts",
+      "default": "./dist/core/types.js"
+    },
     "./rules/openapi": {
       "types": "./dist/rules/openapi/index.d.ts",
       "default": "./dist/rules/openapi/index.js"
     }
   },
   "dependencies": {
-    "@amritk/runtime-validators": "0.7.3",
-    "@amritk/yaml": "0.3.3",
+    "@amritk/runtime-validators": "0.8.0",
+    "@amritk/yaml": "0.3.4",
     "jsonc-parser": "^3.3.1"
   },
   "devDependencies": {
-    "@amritk/resolve-refs": "0.4.3",
+    "@amritk/resolve-refs": "0.4.4",
     "@stoplight/spectral-core": "^1.23.1",
     "@stoplight/spectral-parsers": "^1.0.5",
     "@stoplight/spectral-rulesets": "^1.22.6"