@longzai-intelligence-git/gitignore-formatter 0.1.6 → 0.1.8

package/README.md

@@ -0,0 +1,13 @@
+# @longzai-intelligence-git/gitignore-formatter
+
+Longzai Intelligence Git 的 .gitignore 格式化业务逻辑。
+
+## 简介
+
+治理 .gitignore 文件的格式化口径：把行分类、语义安全归一化与分组编排沉淀为独立业务逻辑包，使各端与命令行的格式化行为一致、可配置、无运行时副作用。
+
+## 能力
+
+- 行分类：空行 / 注释 / 模式 / negation 识别与模式分组匹配
+- 语义安全归一化：行结束符、尾空白、去重、空行合并
+- 分组编排：按配置重组分组或保留原分组输出

package/dist/index.d.ts

@@ -114,6 +114,66 @@ declare function stripTrailingWhitespace(line: string): string;
  */
 declare function normalizeGitignore(content: string, dedupe?: boolean): string;
 //#endregion
+//#region src/forbidden.utils.d.ts
+/**
+ * 禁止忽略项检出引擎。
+ *
+ * 清单内的文件必须被 git 跟踪，任何忽略模式命中即为违例。
+ * `format` 在格式化时政策性剔除命中的忽略模式行，`check` 依据本引擎的检出报告违规。
+ * 判定口径与 git 语义对齐：忽略模式在 git 语义下会忽略仓根目标文件即命中，
+ * negation 取反行本身是解禁表达，视为合规。
+ */
+/**
+ * 单条禁止项违规明细。
+ */
+type ForbiddenHit = {
+  /**
+   * 违规行在原文件中的行号，1 起始。
+   */
+  readonly line: number;
+  /**
+   * 违规模式原文，即去首尾空白后的行内容。
+   */
+  readonly pattern: string;
+  /**
+   * 被该模式命中的禁止项目标文件名。
+   */
+  readonly target: string;
+};
+/**
+ * 判断一条忽略模式是否命中任一禁止项目标。
+ *
+ * 判定分两层：先做分类等价的精确判定，尾斜杠误写形态在此按等价命中，
+ * 再做 glob 通配判定，覆盖 `CLAUDE*` 与 `*.md` 一类宽模式。
+ * 目标恒为仓根文件名，因此含中间斜杠的子路径锚定模式不命中，
+ * 根锚定前导斜杠与双星任意层级前缀剥离后按文件名匹配。
+ *
+ * @param pattern - 忽略模式，应为非 negation 的模式行
+ * @param targets - 禁止项目标清单
+ * @returns 命中的目标文件名，未命中返回 undefined
+ */
+declare function matchForbiddenTarget(pattern: string, targets: readonly string[]): string | undefined;
+/**
+ * 判断单条已归一化的模式是否命中禁止项。
+ *
+ * format 的政策性剔除与分组注入源过滤均以本函数为准。
+ *
+ * @param pattern - 已归一化的模式行
+ * @param targets - 禁止项目标清单
+ * @returns 是否命中
+ */
+declare function isForbiddenPattern(pattern: string, targets: readonly string[]): boolean;
+/**
+ * 检出文件内容中命中禁止项的全部违规行。
+ *
+ * 空行、注释行与 negation 取反行不参与判定。
+ *
+ * @param content - 原始 .gitignore 内容
+ * @param targets - 禁止项目标清单，空清单直接返回空数组
+ * @returns 违规明细数组，按行序排列
+ */
+declare function findForbiddenPatterns(content: string, targets: readonly string[]): ForbiddenHit[];
+//#endregion
 //#region src/format.d.ts
 /**
  * .gitignore 格式化引擎（presets + inject + 分组编排）。
@@ -174,7 +234,9 @@ type GitignoreFileContext = {
  * .gitignore 格式化入口。
  *
  * 根据配置决定是按 preset+groups 重组（含 inject）还是保留原分组，统一应用归一化规则。
- * 缺失 config.gitignore 时退化为纯归一化（无分组、无 inject）。
+ * 缺失 config.gitignore 时退化为纯归一化（无分组、无 inject、无禁止项剔除）。
+ * 存在 gitignore 配置时，命中禁止项的忽略模式行在两条编排路径下均被政策性剔除，
+ * 分组注入源中的命中模式同步过滤，杜绝违规模式经注入回流。
  *
  * @param content - 原始 .gitignore 内容
  * @param config - lzi-git.config.ts 解析得到的配置（可为 undefined，表示无配置文件）
@@ -183,4 +245,4 @@ type GitignoreFileContext = {
  */
 declare function formatGitignore(content: string, config?: LziGitConfig, fileContext?: GitignoreFileContext): string;
 //#endregion
-export { GitignoreFileContext, classifyEquivalent, classifyPattern, formatGitignore, formatGroupHeader, getNegationBody, isBlankLine, isCommentLine, isNegationPattern, normalizeGitignore, resolveEnabledPresets, resolveOptions, stripTrailingWhitespace };
+export { ForbiddenHit, GitignoreFileContext, classifyEquivalent, classifyPattern, findForbiddenPatterns, formatGitignore, formatGroupHeader, getNegationBody, isBlankLine, isCommentLine, isForbiddenPattern, isNegationPattern, matchForbiddenTarget, normalizeGitignore, resolveEnabledPresets, resolveOptions, stripTrailingWhitespace };

package/dist/index.js

@@ -1,12 +1,13 @@
-import{DEFAULT_GITIGNORE_OPTIONS as e,GITIGNORE_PRESETS as t}from"@longzai-intelligence-git/config";function n(e){return e.trim().length===0}function r(e){let t=e.trimStart();return t.length!==0&&t[0]===`#`}function i(e){let t=e.trimStart();return t.length!==0&&t[0]===`!`}function a(e){return e.trimStart().slice(1)}function o(e,t){return e===t||(e.endsWith(`/`)?e.slice(0,-1):e)===(t.endsWith(`/`)?t.slice(0,-1):t)}function s(e,t){let n=e;for(let e=0;e<t.length;e+=1){let r=t[e];if(r!==void 0&&r.patterns.some(e=>o(n,e)))return e}return null}function c(e){if(r(e))return e;let t=e.length;for(;t>0;){let n=e[t-1];if(n===void 0)break;if(n===` `||n===`	`){if(e[t-2]===`\\`)break;--t}else break}return e.slice(0,t)}function l(e){return e.replace(/\r\n/g,`
+import{DEFAULT_GITIGNORE_FORBIDDEN as e,DEFAULT_GITIGNORE_OPTIONS as t,GITIGNORE_PRESETS as n}from"@longzai-intelligence-git/config";function r(e){return e.trim().length===0}function i(e){let t=e.trimStart();return t.length!==0&&t[0]===`#`}function a(e){let t=e.trimStart();return t.length!==0&&t[0]===`!`}function o(e){return e.trimStart().slice(1)}function s(e,t){return e===t||(e.endsWith(`/`)?e.slice(0,-1):e)===(t.endsWith(`/`)?t.slice(0,-1):t)}function c(e,t){let n=e;for(let e=0;e<t.length;e+=1){let r=t[e];if(r!==void 0&&r.patterns.some(e=>s(n,e)))return e}return null}function l(e){if(i(e))return e;let t=e.length;for(;t>0;){let n=e[t-1];if(n===void 0)break;if(n===` `||n===`	`){if(e[t-2]===`\\`)break;--t}else break}return e.slice(0,t)}function u(e){return e.replace(/\r\n/g,`
 `).replace(/\r/g,`
 `).split(`
-`).map(e=>c(e))}function u(e,t){if(!t)return e;let i=/* @__PURE__ */ new Set,a=[];for(let t of e){if(n(t)||r(t)){a.push(t);continue}i.has(t)||(i.add(t),a.push(t))}return a}function d(e){let t=[];for(let r of e){if(n(r)){t.length>0&&!n(t[t.length-1]??``)&&t.push(``);continue}t.push(r)}for(;t.length>0&&n(t[t.length-1]??``);)t.pop();return t}function f(e,t=!0){let n=d(u(l(e),t));return n.length===0?``:`${n.join(`
-`)}\n`}function p(t){return{...e,...t}}function m(e,t){let n=i(e),r=i(t);if(n!==r)return n?1:-1;let o=n?a(e):e,s=r?a(t):t;return o===s?e<t?-1:+(e>t):o<s?-1:1}function h(e){let t=f(e,!0);return t===``?[]:t.split(`
-`).filter(e=>!n(e)&&!r(e))}function g(e){let t=e.trim();return t.startsWith(`#`)?t:`# ${t}`}function _(e){if(e===void 0)return[];let n=Object.keys(t),r=[];for(let i of n){let n=t[i];n!==void 0&&(e[i]??n.default)&&r.push({comment:n.comment,patterns:[...n.patterns]})}return r}function v(e,t){return t===void 0||t.length===0?e:[...e,...t]}function y(e,t,n,r){let i=`
-`.repeat(Math.max(0,n.blankLinesBetweenGroups)+1),a=[],s=/* @__PURE__ */ new Set;for(let i of t){if(i===void 0)continue;let t=[];for(let n of e)s.has(n)||i.patterns.some(e=>o(n,e))&&(t.push(n),s.add(n));if(r)for(let n of i.patterns)e.some(e=>o(e,n))||t.push(n);if(t.length===0){r&&a.push(g(i.comment));continue}n.sortWithinGroup&&t.sort(m),a.push([g(i.comment),...t].join(`
-`))}let c=e.filter(e=>!s.has(e));return c.length>0&&(n.sortWithinGroup&&c.sort(m),a.push([g(n.miscGroupComment),...c].join(`
-`))),a.length===0?``:`${a.join(i)}\n`}function b(e,t){let i=f(e,t.dedupe);if(i===``)return``;let a=i.split(`
-`),o=[],s={header:null,patterns:[]},c=!1;for(let e of a)n(e)||(r(e)?(c&&o.push(s),s={header:e,patterns:[]},c=!0):(s.patterns.push(e),c=!0));if(c&&o.push(s),t.sortWithinGroup)for(let e of o)e.patterns.sort(m);let l=`
-`.repeat(Math.max(0,t.blankLinesBetweenGroups)+1),u=o.map(e=>{let t=[];return e.header!==null&&t.push(e.header),t.push(...e.patterns),t.join(`
-`)}).filter(e=>e.length>0);return u.length===0?``:`${u.join(l)}\n`}function x(e,t,n){let r=t?.gitignore;if(r===void 0)return f(e,!0);let i=p(r.options);if(i.groupByConfig){let t=n?.isRoot??!0,a=i.injectMode===`always`||t;return y(h(e),v(_(r.presets),r.groups),i,a)}return b(e,i)}export{o as classifyEquivalent,s as classifyPattern,x as formatGitignore,g as formatGroupHeader,a as getNegationBody,n as isBlankLine,r as isCommentLine,i as isNegationPattern,f as normalizeGitignore,_ as resolveEnabledPresets,p as resolveOptions,c as stripTrailingWhitespace};
+`).map(e=>l(e))}function d(e,t){if(!t)return e;let n=/* @__PURE__ */ new Set,a=[];for(let t of e){if(r(t)||i(t)){a.push(t);continue}n.has(t)||(n.add(t),a.push(t))}return a}function f(e){let t=[];for(let n of e){if(r(n)){t.length>0&&!r(t[t.length-1]??``)&&t.push(``);continue}t.push(n)}for(;t.length>0&&r(t[t.length-1]??``);)t.pop();return t}function p(e,t=!0){let n=f(d(u(e),t));return n.length===0?``:`${n.join(`
+`)}\n`}function m(e,t){let n=`^${[...e].map(e=>e===`*`?`[^/]*`:e===`?`?`[^/]`:e.replace(/[.*+?^${}()|[\]\\]/g,`\\$&`)).join(``)}$`;return new RegExp(n).test(t)}function h(e,t){for(let n of t)if(s(e,n))return n;let n=e;if(n.startsWith(`/`))n=n.slice(1);else if(n.startsWith(`**/`))n=n.slice(3);else if(n.includes(`/`))return;if(!(n.length===0||n.includes(`/`)||n.endsWith(`/`))){for(let e of t)if(m(n,e))return e}}function g(e,t){return h(e,t)!==void 0}function _(e,t){if(t.length===0)return[];let n=e.split(`
+`),o=[];for(let e=0;e<n.length;e+=1){let s=n[e]??``;if(r(s)||i(s))continue;let c=s.trim();if(a(c))continue;let l=h(c,t);l!==void 0&&o.push({line:e+1,pattern:c,target:l})}return o}function v(e){return{...t,...e}}function y(e,t){let n=a(e),r=a(t);if(n!==r)return n?1:-1;let i=n?o(e):e,s=r?o(t):t;return i===s?e<t?-1:+(e>t):i<s?-1:1}function b(e){let t=p(e,!0);return t===``?[]:t.split(`
+`).filter(e=>!r(e)&&!i(e))}function x(e){let t=e.trim();return t.startsWith(`#`)?t:`# ${t}`}function S(e){if(e===void 0)return[];let t=Object.keys(n),r=[];for(let i of t){let t=n[i];t!==void 0&&(e[i]??t.default)&&r.push({comment:t.comment,patterns:[...t.patterns]})}return r}function C(e,t){return t===void 0||t.length===0?e:[...e,...t]}function w(e,t,n,r){let i=`
+`.repeat(Math.max(0,n.blankLinesBetweenGroups)+1),a=[],o=/* @__PURE__ */ new Set;for(let i of t){if(i===void 0)continue;let t=[];for(let n of e)o.has(n)||i.patterns.some(e=>s(n,e))&&(t.push(n),o.add(n));if(r)for(let n of i.patterns)e.some(e=>s(e,n))||t.push(n);if(t.length===0){r&&a.push(x(i.comment));continue}n.sortWithinGroup&&t.sort(y),a.push([x(i.comment),...t].join(`
+`))}let c=e.filter(e=>!o.has(e));return c.length>0&&(n.sortWithinGroup&&c.sort(y),a.push([x(n.miscGroupComment),...c].join(`
+`))),a.length===0?``:`${a.join(i)}\n`}function T(e,t,n){let a=p(e,t.dedupe);if(a===``)return``;let o=a.split(`
+`),s=[],c={header:null,patterns:[]},l=!1;for(let e of o)if(!r(e)){if(i(e))l&&s.push(c),c={header:e,patterns:[]},l=!0;else if(n.length>0&&g(e,n))continue;else c.patterns.push(e),l=!0}if(l&&s.push(c),t.sortWithinGroup)for(let e of s)e.patterns.sort(y);let u=`
+`.repeat(Math.max(0,t.blankLinesBetweenGroups)+1),d=s.map(e=>{let t=[];return e.header!==null&&t.push(e.header),t.push(...e.patterns),t.join(`
+`)}).filter(e=>e.length>0);return d.length===0?``:`${d.join(u)}\n`}function E(t,n,r){let i=n?.gitignore;if(i===void 0)return p(t,!0);let a=v(i.options),o=i.forbidden??e;if(a.groupByConfig){let e=r?.isRoot??!0,n=a.injectMode===`always`||e;return w(b(t).filter(e=>!g(e,o)),C(S(i.presets),i.groups).map(e=>({...e,patterns:e.patterns.filter(e=>!g(e,o))})),a,n)}return T(t,a,o)}export{s as classifyEquivalent,c as classifyPattern,_ as findForbiddenPatterns,E as formatGitignore,x as formatGroupHeader,o as getNegationBody,r as isBlankLine,i as isCommentLine,g as isForbiddenPattern,a as isNegationPattern,h as matchForbiddenTarget,p as normalizeGitignore,S as resolveEnabledPresets,v as resolveOptions,l as stripTrailingWhitespace};

package/package.json

@@ -1,7 +1,14 @@
 {
   "name": "@longzai-intelligence-git/gitignore-formatter",
-  "version": "0.1.6",
-  "description": "Longzai Intelligence Git - .gitignore 格式化业务逻辑",
+  "version": "0.1.8",
+  "description": "Longzai Intelligence Git Gitignore 格式化器",
+  "keywords": [
+    "longzai-intelligence",
+    "git",
+    "gitignore",
+    "formatter",
+    "format"
+  ],
   "files": [
     "dist"
   ],
@@ -30,7 +37,7 @@
     "clean": "lzi-dev-cli clean"
   },
   "dependencies": {
-    "@longzai-intelligence-git/config": "0.1.6"
+    "@longzai-intelligence-git/config": "0.1.8"
   },
   "devDependencies": {},
   "peerDependencies": {}