@longzai-intelligence-oxlint/lzi-builder-config-plugin 0.1.24

package/README.md

@@ -0,0 +1,12 @@
+# @longzai-intelligence-oxlint/lzi-builder-config-plugin
+
+Longzai Intelligence Oxlint 的 lzi-builder 构建配置治理插件，治理 bin 产物的 shebang 注入形态。
+
+## 简介
+
+lzi-builder 产物缺 shebang 会让 npm 安装链软链直执行交系统 shell 解析而报语法错误。本插件在静态检查阶段校验 bin 指向 dist 产物的包是否在构建配置注入 banner，防止缺陷复发。规范正源见 architecture 仓 `cli-bin-shebang` 指南。
+
+## 能力
+
+- `require-bin-banner` — 校验 bin 指向 dist 产物的包在 `lzi-builder.config.ts` 注入 shebang banner，同时拦截可发布包 bin 直指 src 源码的发布形态违规
+- 同时兼容 Oxlint 与 ESLint 运行时

package/dist/configs/recommended.d.ts

@@ -0,0 +1,9 @@
+import "../rolldown-runtime-BqT_7tdF.js";
+import { OxlintRules } from "@longzai-intelligence-oxlint/core";
+//#region src/configs/recommended.config.d.ts
+/**
+ * 推荐规则集
+ */
+declare const recommended: OxlintRules;
+//#endregion
+export { recommended };

package/dist/configs/recommended.js

@@ -0,0 +1 @@
+import"../rolldown-runtime-BqT_7tdF.js";const e={"@longzai-intelligence-oxlint/lzi-builder-config-plugin/require-bin-banner":`error`};export{e as recommended};

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+import "./rolldown-runtime-BqT_7tdF.js";
+//#region src/rules/require-bin-banner.rule.d.ts
+/**
+ * 要求 bin 指向 dist 产物的包注入 shebang banner 的门禁规则
+ *
+ * @remarks
+ *   以构建配置文件为守卫文件，判定本配置文本与同级 bin 字段的匹配关系
+ *   统一配置在同目录存在 builder 主配置时不具权威性，跳过判定
+ */
+declare const requireBinBannerRule: import("@oxlint/plugins").Rule;
+//#endregion
+//#region src/index.d.ts
+/**
+ * lzi-builder-config 插件实例
+ */
+declare const lziBuilderConfigPlugin: import("@oxlint/plugins").Plugin;
+//#endregion
+export { lziBuilderConfigPlugin as default, lziBuilderConfigPlugin, requireBinBannerRule };

package/dist/index.js

@@ -0,0 +1 @@
+import"./rolldown-runtime-BqT_7tdF.js";import{defineRule as e,eslintCompatPlugin as t}from"@oxlint/plugins";import{existsSync as n,readFileSync as r}from"node:fs";import{dirname as i,join as a}from"node:path";const o=/(^|\/)lzi-builder\.config\.(ts|mts)$/,s=`lzi.config.ts`,c=[`lzi-builder.config.ts`,`lzi-builder.config.mts`],l=/banner\s*:\s*['"]#!/,u=/banner\s*:\s*\{[^}]*#!/,d=/(^|\/)dist\//,f=/(^|\/)src\//;function p(e){return typeof e==`object`&&!!e}function m(e){let t=e.replace(/\\/g,`/`);return o.test(t)||t.endsWith(`/${s}`)}function h(e){let t=e.bin;return typeof t==`string`?[t]:p(t)?Object.values(t).filter(e=>typeof e==`string`):[]}function g(e){return l.test(e)||u.test(e)}function _(e){let t=a(e,`package.json`);if(!n(t))return null;try{let e=JSON.parse(r(t,`utf8`));return p(e)?e:null}catch{return null}}function v(e,t){let n=h(e);return n.length===0?null:n.some(e=>d.test(e.replace(/^\.\//,``)))?g(t)?null:`missingBanner`:e.private===!0?null:n.some(e=>f.test(e.replace(/^\.\//,``)))?`binPointsToSource`:null}const y={missingBanner:`bin 入口指向 dist 产物但构建配置缺少 banner，发布后经 npm 软链直执行会交系统 shell 解析而报语法错误。请配置 "banner: '#!/usr/bin/env bun'"，规范见 architecture 仓 "docs/best-practices/build-and-toolchain/guides/cli-bin-shebang.md"。`,binPointsToSource:`可发布包的 bin 入口指向 src 源码，安装链软链直指 TS 源码无法执行。请将 bin 指向 "dist" 产物并配置 banner。`},b=e({meta:{type:`problem`,docs:{description:`要求 bin 指向 dist 产物的包在构建配置注入 shebang banner`}},createOnce(e){return{before(){let t=e.filename;if(!m(t))return!1},Program(t){let r=i(e.filename);if(e.filename.replace(/\\/g,`/`).endsWith(`/${s}`)&&c.some(e=>n(a(r,e))))return;let o=_(r);if(o===null)return;let l=v(o,e.sourceCode.text);l!==null&&e.report({node:t,message:y[l]})}}}}),x=t({meta:{name:`@longzai-intelligence-oxlint/lzi-builder-config-plugin`},rules:{"require-bin-banner":b}});export{x as default,x as lziBuilderConfigPlugin,b as requireBinBannerRule};

package/dist/rolldown-runtime-BqT_7tdF.js

@@ -0,0 +1 @@
+import"node:module";export{};

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@longzai-intelligence-oxlint/lzi-builder-config-plugin",
+  "version": "0.1.24",
+  "license": "UNLICENSED",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./configs/recommended": {
+      "types": "./dist/configs/recommended.d.ts",
+      "import": "./dist/configs/recommended.js"
+    }
+  },
+  "scripts": {
+    "build": "lzi-builder",
+    "build:prod": "NODE_ENV=production bun run build",
+    "prepublishOnly": "bun run build:prod",
+    "dev": "lzi-builder --watch",
+    "clean": "lzi-dev-cli clean",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "oxlint && oxfmt --check",
+    "lint:fix": "oxlint --fix && oxfmt",
+    "typecheck": "bun run typecheck:app && bun run typecheck:node && bun run typecheck:test",
+    "typecheck:app": "lzi-tsgo typecheck tsconfig/app.json",
+    "typecheck:node": "lzi-tsgo typecheck tsconfig/node.json",
+    "typecheck:test": "lzi-tsgo typecheck tsconfig/test.json"
+  },
+  "dependencies": {
+    "@longzai-intelligence-oxlint/core": "0.1.24",
+    "@oxlint/plugins": "^1.74.0"
+  },
+  "devDependencies": {
+    "@vitest/coverage-v8": "^4.1.10"
+  },
+  "peerDependencies": {
+    "oxlint": ">=1.0.0"
+  }
+}