@alint-js/core 0.0.10 → 0.0.12

package/README.md

@@ -0,0 +1,78 @@
+# `@alint-js/core`
+
+The public SDK and run engine for `alint`.
+
+## What it does
+
+This package provides the core APIs used by configs, plugins, rules, language processors, and agent adapters:
+
+- `defineConfig`, `definePlugin`, and `defineRule`
+- rule registry and flat config normalization
+- source runtime helpers
+- built-in JavaScript source extraction
+- model resolution by size and capability
+- diagnostics and progress payload types
+- `runAlint`
+- framework-neutral agent contracts under `@alint-js/core/agent`
+
+## How to use
+
+Define an `alint` config:
+
+```ts
+import examplePlugin from '@alint-js/plugin-example'
+
+import { defineConfig } from '@alint-js/core'
+
+export default defineConfig([
+  {
+    files: ['**/*.{js,ts,jsx,tsx}'],
+    plugins: {
+      example: examplePlugin,
+    },
+    rules: {
+      'example/no-redundant-jsdoc': 'warn',
+    },
+  },
+])
+```
+
+Write a rule:
+
+```ts
+import { defineRule } from '@alint-js/core'
+
+export const rule = defineRule({
+  create: ctx => ({
+    async onTarget(target) {
+      const model = await ctx.model({ size: 'small' })
+
+      ctx.report({
+        filePath: target.file.path,
+        loc: target.loc,
+        message: `reviewed with ${model.id}`,
+      })
+    },
+  }),
+})
+```
+
+Use the agent contract for tool-using rules:
+
+```ts
+import { requireAgent } from '@alint-js/core/agent'
+
+const agent = requireAgent(ctx)
+```
+
+## When to use
+
+- You are writing an `alint` plugin or rule package.
+- You are adding a language processor or source extractor.
+- You are embedding `alint` in another tool.
+- You are implementing an `AgentAdapter`.
+
+## When not to use
+
+- Use `@alint-js/cli` for command-line usage.
+- Use `@alint-js/config` for setup TOML and config-file helpers only.

package/dist/index.mjs

@@ -1,9 +1,9 @@
 import { minimatch } from "minimatch";
 import { isAbsolute, relative, resolve } from "pathe";
-import { parseSync } from "oxc-parser";
 import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
 import { dirname, extname, isAbsolute as isAbsolute$1, join, relative as relative$1, resolve as resolve$1, sep } from "node:path";
 import { clamp } from "es-toolkit";
+import { parseSync } from "oxc-parser";
 import { AsyncLocalStorage } from "node:async_hooks";
 import process, { cwd } from "node:process";
 import { errorCauseFrom, errorMessageFrom } from "@moeru/std/error";
@@ -309,9 +309,14 @@ function inferLanguage(path) {
 	}
 }
 //#endregion
+//#region src/core/languages/js/parser.ts
+function parseSync$1(filename, sourceText, options) {
+	return parseSync(filename, sourceText, options);
+}
+//#endregion
 //#region src/core/languages/js/extract.ts
 function extractJsSourceTargets(file) {
-	const result = parseSync(file.path, file.text, { sourceType: "module" });
+	const result = parseSync$1(file.path, file.text, { sourceType: "module" });
 	const state = {
 		bindingNodes: /* @__PURE__ */ new Map(),
 		exportedNodes: /* @__PURE__ */ new Set(),
@@ -648,7 +653,7 @@ function createBuiltInLanguageRegistry() {
 }
 //#endregion
 //#region package.json
-var version = "0.0.10";
+var version = "0.0.12";
 //#endregion
 //#region src/dsl/registry.ts
 function buildRuleRegistry(config) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@alint-js/core",
   "type": "module",
-  "version": "0.0.10",
+  "version": "0.0.12",
   "exports": {
     ".": {
       "types": "./dist/index.d.mts",