pickier 0.1.18 → 0.1.19

package/dist/plugins/publint.d.ts

@@ -0,0 +1,11 @@
+import {  } from '../rules/publint';
+import type { PickierPlugin } from '../types';
+/**
+ * publint plugin for pickier.
+ *
+ * Validates package.json files for correct npm publishing configuration.
+ * Checks exports/imports ordering, field types, file format, module system, etc.
+ *
+ * Ported from publint (https://publint.dev).
+ */
+export declare const publintPlugin: PickierPlugin;

package/dist/plugins/utils.d.ts

@@ -1,2 +1,3 @@
 import type { RuleModule } from '../types';
-export declare function codeOnly(rule: RuleModule): RuleModule;
+export declare function codeOnly(rule: RuleModule): RuleModule;
+export declare function packageJsonOnly(rule: RuleModule): RuleModule;

package/dist/rules/general/prefer-template.d.ts

@@ -1,8 +1,2 @@
 import type { RuleModule } from '../../types';
-/**
- * Prefer template literals over string concatenation
- *
- * Flags cases like: 'hello ' + name + '!'
- * Suggests: `hello ${name}!`
- */
 export declare const preferTemplate: RuleModule;

package/dist/rules/markdown/no-duplicate-heading.d.ts

@@ -1,5 +1,10 @@
 import type { RuleModule } from '../../types';
 /**
  * MD024 - Multiple headings with the same content
+ *
+ * Uses "siblings only" mode by default: only flags duplicate headings
+ * within the same parent section. This avoids false positives in
+ * changelogs and other documents where headings naturally repeat
+ * across different sections (e.g., each version has "Features", "Fixes").
  */
 export declare const noDuplicateHeadingRule: RuleModule;

package/dist/rules/publint/bin-file-not-executable.d.ts

@@ -0,0 +1,2 @@
+import type { RuleModule } from '../../types';
+export declare const binFileNotExecutable: RuleModule;

package/dist/rules/publint/deprecated-field-jsnext.d.ts

@@ -0,0 +1,2 @@
+import type { RuleModule } from '../../types';
+export declare const deprecatedFieldJsnext: RuleModule;

package/dist/rules/publint/exports-default-should-be-last.d.ts

@@ -0,0 +1,2 @@
+import type { RuleModule } from '../../types';
+export declare const exportsDefaultShouldBeLast: RuleModule;

package/dist/rules/publint/exports-fallback-array-use.d.ts

@@ -0,0 +1,2 @@
+import type { RuleModule } from '../../types';
+export declare const exportsFallbackArrayUse: RuleModule;

package/dist/rules/publint/exports-missing-root-entrypoint.d.ts

@@ -0,0 +1,2 @@
+import type { RuleModule } from '../../types';
+export declare const exportsMissingRootEntrypoint: RuleModule;

package/dist/rules/publint/exports-module-should-be-esm.d.ts

@@ -0,0 +1,2 @@
+import type { RuleModule } from '../../types';
+export declare const exportsModuleShouldBeEsm: RuleModule;

package/dist/rules/publint/exports-module-should-precede-require.d.ts

@@ -0,0 +1,2 @@
+import type { RuleModule } from '../../types';
+export declare const exportsModuleShouldPrecedeRequire: RuleModule;

package/dist/rules/publint/exports-types-should-be-first.d.ts

@@ -0,0 +1,2 @@
+import type { RuleModule } from '../../types';
+export declare const exportsTypesShouldBeFirst: RuleModule;

package/dist/rules/publint/exports-value-invalid.d.ts

@@ -0,0 +1,2 @@
+import type { RuleModule } from '../../types';
+export declare const exportsValueInvalid: RuleModule;

package/dist/rules/publint/field-invalid-value-type.d.ts

@@ -0,0 +1,2 @@
+import type { RuleModule } from '../../types';
+export declare const fieldInvalidValueType: RuleModule;

package/dist/rules/publint/file-does-not-exist.d.ts

@@ -0,0 +1,2 @@
+import type { RuleModule } from '../../types';
+export declare const fileDoesNotExist: RuleModule;

package/dist/rules/publint/file-invalid-format.d.ts

@@ -0,0 +1,2 @@
+import type { RuleModule } from '../../types';
+export declare const fileInvalidFormat: RuleModule;

package/dist/rules/publint/has-module-but-no-exports.d.ts

@@ -0,0 +1,2 @@
+import type { RuleModule } from '../../types';
+export declare const hasModuleButNoExports: RuleModule;

package/dist/rules/publint/imports-default-should-be-last.d.ts

@@ -0,0 +1,2 @@
+import type { RuleModule } from '../../types';
+export declare const importsDefaultShouldBeLast: RuleModule;

package/dist/rules/publint/imports-key-invalid.d.ts

@@ -0,0 +1,2 @@
+import type { RuleModule } from '../../types';
+export declare const importsKeyInvalid: RuleModule;

package/dist/rules/publint/imports-module-should-precede-require.d.ts

@@ -0,0 +1,2 @@
+import type { RuleModule } from '../../types';
+export declare const importsModuleShouldPrecedeRequire: RuleModule;

package/dist/rules/publint/imports-value-invalid.d.ts

@@ -0,0 +1,2 @@
+import type { RuleModule } from '../../types';
+export declare const importsValueInvalid: RuleModule;

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

@@ -0,0 +1,20 @@
+export { useType } from './use-type';
+export { localDependency } from './local-dependency';
+export { deprecatedFieldJsnext } from './deprecated-field-jsnext';
+export { hasModuleButNoExports } from './has-module-but-no-exports';
+export { fieldInvalidValueType } from './field-invalid-value-type';
+export { exportsTypesShouldBeFirst } from './exports-types-should-be-first';
+export { exportsDefaultShouldBeLast } from './exports-default-should-be-last';
+export { exportsModuleShouldPrecedeRequire } from './exports-module-should-precede-require';
+export { exportsValueInvalid } from './exports-value-invalid';
+export { exportsMissingRootEntrypoint } from './exports-missing-root-entrypoint';
+export { exportsFallbackArrayUse } from './exports-fallback-array-use';
+export { importsKeyInvalid } from './imports-key-invalid';
+export { importsValueInvalid } from './imports-value-invalid';
+export { importsDefaultShouldBeLast } from './imports-default-should-be-last';
+export { importsModuleShouldPrecedeRequire } from './imports-module-should-precede-require';
+export { fileDoesNotExist } from './file-does-not-exist';
+export { fileInvalidFormat } from './file-invalid-format';
+export { moduleShouldBeEsm } from './module-should-be-esm';
+export { binFileNotExecutable } from './bin-file-not-executable';
+export { exportsModuleShouldBeEsm } from './exports-module-should-be-esm';

package/dist/rules/publint/local-dependency.d.ts

@@ -0,0 +1,2 @@
+import type { RuleModule } from '../../types';
+export declare const localDependency: RuleModule;

package/dist/rules/publint/module-should-be-esm.d.ts

@@ -0,0 +1,2 @@
+import type { RuleModule } from '../../types';
+export declare const moduleShouldBeEsm: RuleModule;

package/dist/rules/publint/use-type.d.ts

@@ -0,0 +1,2 @@
+import type { RuleModule } from '../../types';
+export declare const useType: RuleModule;

package/dist/rules/publint/utils.d.ts

@@ -0,0 +1,73 @@
+import type { LintIssue } from '../../types';
+/**
+ * Safely parse package.json content. Returns null on failure.
+ */
+export declare function parsePackageJson(content: string): Record<string, any> | null;
+/**
+ * Find the line number where a JSON key path appears in the raw content.
+ * Walks through the path segments to find the most specific match.
+ */
+export declare function findJsonKeyLine(content: string, keyPath: string[]): number;
+/**
+ * Get the package directory from a file path (dirname of the package.json).
+ */
+export declare function getPkgDir(filePath: string): string;
+/**
+ * Resolve a package-relative path to an absolute path.
+ */
+export declare function resolvePkgPath(pkgDir: string, relativePath: string): string;
+/**
+ * Format a JSON path for human-readable messages.
+ * e.g. ['exports', '.', 'types'] -> 'pkg.exports["."].types'
+ */
+export declare function formatPkgPath(path: string[]): string;
+/**
+ * Get a published field value, respecting publishConfig overrides.
+ * Returns [value, path] tuple.
+ */
+export declare function getPublishedField(pkg: Record<string, any>, field: string): [any, string[]];
+/**
+ * Detect the code format (ESM, CJS, mixed, or unknown) from file content.
+ */
+export declare function getCodeFormat(code: string): CodeFormat;
+/**
+ * Determine the expected code format from a file path and nearest package.json type field.
+ */
+export declare function getFilePathFormat(filePath: string, pkgType?: string): 'ESM' | 'CJS';
+/**
+ * Get the expected file extension for a given code format.
+ */
+export declare function getCodeFormatExtension(format: CodeFormat): string;
+/**
+ * Whether an extension is explicit (.mjs or .cjs).
+ */
+export declare function isExplicitExtension(ext: string): boolean;
+/**
+ * Check if a file path has a lintable extension for format checking.
+ */
+export declare function isLintableFilePath(filePath: string): boolean;
+/**
+ * Check if a file starts with a shebang.
+ */
+export declare function startsWithShebang(code: string): boolean;
+/**
+ * Recursively crawl an exports or imports object, calling visitor for each node.
+ * Handles string values, array values (fallback), and object values (conditions/subpaths).
+ */
+export declare function crawlExportsOrImports(value: any, basePath: string[], isImports: boolean, visitor: CrawlVisitor): void;
+/**
+ * Create a LintIssue for a publint rule.
+ */
+export declare function createIssue(filePath: string, content: string, keyPath: string[], ruleId: string, message: string, severity: 'warning' | 'error', help?: string): LintIssue;
+// Crawl exports/imports types
+export declare interface CrawlContext {
+  path: string[]
+  isImports: boolean
+}
+export type CodeFormat = 'ESM' | 'CJS' | 'mixed' | 'unknown'
+export type CrawlVisitor = (
+  value: any,
+  ctx: CrawlContext,
+  /** The keys of the current object level (for condition ordering checks) */
+  objectKeys?: string[],
+) => void