repopo 0.7.1 → 0.8.0

package/esm/policyDefiners/defineFileHeaderPolicy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"defineFileHeaderPolicy.d.ts","sourceRoot":"","sources":["../../src/policyDefiners/defineFileHeaderPolicy.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACX,gBAAgB,EAGhB,MAAM,cAAc,CAAC;AAItB;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACtC;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,yBAChB,SAAQ,OAAO,CAAC,sBAAsB,CAAC;IACvC,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,sBAAsB,KAAK,MAAM,CAAC;CACtE;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACrC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,yBAAyB,GAC/B,gBAAgB,CAAC,sBAAsB,CAAC,CAiE1C"}
+{"version":3,"file":"defineFileHeaderPolicy.d.ts","sourceRoot":"","sources":["../../src/policyDefiners/defineFileHeaderPolicy.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACX,gBAAgB,EAGhB,MAAM,cAAc,CAAC;AAItB;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACtC;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,yBAChB,SAAQ,OAAO,CAAC,sBAAsB,CAAC;IACvC,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,sBAAsB,KAAK,MAAM,CAAC;CACtE;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACrC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,yBAAyB,GAC/B,gBAAgB,CAAC,sBAAsB,CAAC,CAkE1C"}

package/esm/policyDefiners/defineFileHeaderPolicy.js

@@ -34,13 +34,14 @@ export function defineFileHeaderPolicy(name, config) {
                 name,
                 file,
                 autoFixable: true,
+                errorMessages: [],
             };
             // TODO: Consider reading only the first 512B or so since headers are typically
             // at the beginning of the file.
             const content = await readFile(file, { encoding: "utf8" });
             const failed = !regex.test(content);
             if (failed) {
-                failResult.errorMessage = `${extname(file)} file missing header`;
+                failResult.errorMessages.push(`${extname(file)} file missing header`);
             }
             if (failed) {
                 if (resolve) {

package/esm/policyDefiners/defineFileHeaderPolicy.js.map

@@ -1 +1 @@
-{"version":3,"file":"defineFileHeaderPolicy.js","sourceRoot":"","sources":["../../src/policyDefiners/defineFileHeaderPolicy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,GAAG,IAAI,OAAO,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAOhC,MAAM,cAAc,GAAG,aAAa,CAAC;AA+CrC;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CACrC,IAAY,EACZ,MAAiC;IAEjC,MAAM,GAAG,GAAG,MAAM,CAAC,WAAW,EAAE,MAAM,IAAI,EAAE,CAAC;IAC7C,MAAM,KAAK,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC;IACtC,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;IAClC,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,EAAE,MAAM,IAAI,EAAE,CAAC;IAE5C,2EAA2E;IAC3E,mGAAmG;IACnG,MAAM,OAAO,GAAG,CAAC,IAAY,EAAU,EAAE,CACxC,IAAI;SACF,KAAK,CAAC,OAAO,CAAC;SACd,GAAG,CACH,CAAC,IAAI,EAAE,EAAE,CACR,GAAG,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,GAAG,GAAG,EAAE,CAC/D;SACA,IAAI,CAAC,EAAE,CAAC;SACR,OAAO,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC,CAAC,uCAAuC;IAE9E,wFAAwF;IACxF,0FAA0F;IAC1F,MAAM,KAAK,GAAG,IAAI,MAAM,CACvB,IAAI,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC,KAAK,IAAI,EAAE,CAC1F,CAAC;IAEF,OAAO;QACN,IAAI;QACJ,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,EAAE,EAAE;YAC1D,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;gBAChC,OAAO,IAAI,CAAC;YACb,CAAC;YAED,MAAM,UAAU,GAAkB;gBACjC,IAAI;gBACJ,IAAI;gBACJ,WAAW,EAAE,IAAI;aACjB,CAAC;YAEF,+EAA+E;YAC/E,gCAAgC;YAChC,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;YAC3D,MAAM,MAAM,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAEpC,IAAI,MAAM,EAAE,CAAC;gBACZ,UAAU,CAAC,YAAY,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,sBAAsB,CAAC;YAClE,CAAC;YAED,IAAI,MAAM,EAAE,CAAC;gBACZ,IAAI,OAAO,EAAE,CAAC;oBACb,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;oBAC1D,MAAM,SAAS,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;oBAElC,MAAM,SAAS,GAAoB;wBAClC,GAAG,UAAU;wBACb,QAAQ,EAAE,IAAI;qBACd,CAAC;oBAEF,OAAO,SAAS,CAAC;gBAClB,CAAC;gBACD,OAAO,UAAU,CAAC;YACnB,CAAC;YAED,OAAO,IAAI,CAAC;QACb,CAAC;KACD,CAAC;AACH,CAAC","sourcesContent":["import { readFile, writeFile } from \"node:fs/promises\";\nimport { EOL as newline } from \"node:os\";\nimport { extname } from \"pathe\";\nimport type {\n\tPolicyDefinition,\n\tPolicyFailure,\n\tPolicyFixResult,\n} from \"../policy.js\";\n\nconst trailingSpaces = /\\s*\\\\r\\?\\\\n/;\n\n/**\n * @alpha\n */\nexport interface FileHeaderPolicyConfig {\n\t/**\n\t * The text to use as the header.\n\t */\n\theaderText: string;\n\n\t/**\n\t * An optional string that will be appended to the headerText.\n\t */\n\tautoGenText?: string;\n}\n\n/**\n * @alpha\n */\nexport interface FileHeaderGeneratorConfig\n\textends Partial<FileHeaderPolicyConfig> {\n\tmatch: RegExp;\n\n\t/**\n\t * Regex matching header prefix (e.g. `/*!\\r?\\n`)\n\t */\n\theaderStart?: RegExp;\n\n\t/**\n\t * Regex matching beginning of each line (e.g. ' * ')\n\t */\n\tlineStart: RegExp;\n\n\t/**\n\t * Regex matching the end of each line (e.g., `\\r?\\n`)\n\t */\n\tlineEnd: RegExp;\n\n\t/**\n\t * Regex matching the header postfix.\n\t */\n\theaderEnd?: RegExp;\n\n\treplacer: (content: string, config: FileHeaderPolicyConfig) => string;\n}\n\n/**\n * Given a {@link FileHeaderPolicyConfig}, produces a function that detects correct file headers\n * and returns an error string if the header is missing or incorrect.\n *\n * @alpha\n */\nexport function defineFileHeaderPolicy(\n\tname: string,\n\tconfig: FileHeaderGeneratorConfig,\n): PolicyDefinition<FileHeaderPolicyConfig> {\n\tconst pre = config.headerStart?.source ?? \"\";\n\tconst start = config.lineStart.source;\n\tconst end = config.lineEnd.source;\n\tconst post = config.headerEnd?.source ?? \"\";\n\n\t// Helper which constructs a matching RegExp from a given multiline string.\n\t// (See https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions#escaping)\n\tconst toRegex = (text: string): string =>\n\t\ttext\n\t\t\t.split(newline)\n\t\t\t.map(\n\t\t\t\t(line) =>\n\t\t\t\t\t`${start}${line.replace(/[$()*+.?[\\\\\\]^{|}]/g, \"\\\\$&\")}${end}`,\n\t\t\t)\n\t\t\t.join(\"\")\n\t\t\t.replace(trailingSpaces, \"\\\\r?\\\\n\"); // Trim trailing spaces at end-of-line.\n\n\t// Detection regex matches the header start (if any), followed by lines in 'headerText',\n\t// optionally followed by lines in the 'autoGenText', and finally the header end (if any).\n\tconst regex = new RegExp(\n\t\t`^${pre}${toRegex(config.headerText ?? \"\")}(${toRegex(config.autoGenText ?? \"\")})?${post}`,\n\t);\n\n\treturn {\n\t\tname,\n\t\tmatch: config.match,\n\t\thandler: async ({ file, resolve, config: policyConfig }) => {\n\t\t\tif (policyConfig === undefined) {\n\t\t\t\treturn true;\n\t\t\t}\n\n\t\t\tconst failResult: PolicyFailure = {\n\t\t\t\tname,\n\t\t\t\tfile,\n\t\t\t\tautoFixable: true,\n\t\t\t};\n\n\t\t\t// TODO: Consider reading only the first 512B or so since headers are typically\n\t\t\t// at the beginning of the file.\n\t\t\tconst content = await readFile(file, { encoding: \"utf8\" });\n\t\t\tconst failed = !regex.test(content);\n\n\t\t\tif (failed) {\n\t\t\t\tfailResult.errorMessage = `${extname(file)} file missing header`;\n\t\t\t}\n\n\t\t\tif (failed) {\n\t\t\t\tif (resolve) {\n\t\t\t\t\tconst newContent = config.replacer(content, policyConfig);\n\t\t\t\t\tawait writeFile(file, newContent);\n\n\t\t\t\t\tconst fixResult: PolicyFixResult = {\n\t\t\t\t\t\t...failResult,\n\t\t\t\t\t\tresolved: true,\n\t\t\t\t\t};\n\n\t\t\t\t\treturn fixResult;\n\t\t\t\t}\n\t\t\t\treturn failResult;\n\t\t\t}\n\n\t\t\treturn true;\n\t\t},\n\t};\n}\n"]}
+{"version":3,"file":"defineFileHeaderPolicy.js","sourceRoot":"","sources":["../../src/policyDefiners/defineFileHeaderPolicy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,GAAG,IAAI,OAAO,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAOhC,MAAM,cAAc,GAAG,aAAa,CAAC;AA+CrC;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CACrC,IAAY,EACZ,MAAiC;IAEjC,MAAM,GAAG,GAAG,MAAM,CAAC,WAAW,EAAE,MAAM,IAAI,EAAE,CAAC;IAC7C,MAAM,KAAK,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC;IACtC,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;IAClC,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,EAAE,MAAM,IAAI,EAAE,CAAC;IAE5C,2EAA2E;IAC3E,mGAAmG;IACnG,MAAM,OAAO,GAAG,CAAC,IAAY,EAAU,EAAE,CACxC,IAAI;SACF,KAAK,CAAC,OAAO,CAAC;SACd,GAAG,CACH,CAAC,IAAI,EAAE,EAAE,CACR,GAAG,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,GAAG,GAAG,EAAE,CAC/D;SACA,IAAI,CAAC,EAAE,CAAC;SACR,OAAO,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC,CAAC,uCAAuC;IAE9E,wFAAwF;IACxF,0FAA0F;IAC1F,MAAM,KAAK,GAAG,IAAI,MAAM,CACvB,IAAI,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC,KAAK,IAAI,EAAE,CAC1F,CAAC;IAEF,OAAO;QACN,IAAI;QACJ,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,EAAE,EAAE;YAC1D,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;gBAChC,OAAO,IAAI,CAAC;YACb,CAAC;YAED,MAAM,UAAU,GAAkB;gBACjC,IAAI;gBACJ,IAAI;gBACJ,WAAW,EAAE,IAAI;gBACjB,aAAa,EAAE,EAAE;aACjB,CAAC;YAEF,+EAA+E;YAC/E,gCAAgC;YAChC,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;YAC3D,MAAM,MAAM,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAEpC,IAAI,MAAM,EAAE,CAAC;gBACZ,UAAU,CAAC,aAAa,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;YACvE,CAAC;YAED,IAAI,MAAM,EAAE,CAAC;gBACZ,IAAI,OAAO,EAAE,CAAC;oBACb,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;oBAC1D,MAAM,SAAS,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;oBAElC,MAAM,SAAS,GAAoB;wBAClC,GAAG,UAAU;wBACb,QAAQ,EAAE,IAAI;qBACd,CAAC;oBAEF,OAAO,SAAS,CAAC;gBAClB,CAAC;gBACD,OAAO,UAAU,CAAC;YACnB,CAAC;YAED,OAAO,IAAI,CAAC;QACb,CAAC;KACD,CAAC;AACH,CAAC","sourcesContent":["import { readFile, writeFile } from \"node:fs/promises\";\nimport { EOL as newline } from \"node:os\";\nimport { extname } from \"pathe\";\nimport type {\n\tPolicyDefinition,\n\tPolicyFailure,\n\tPolicyFixResult,\n} from \"../policy.js\";\n\nconst trailingSpaces = /\\s*\\\\r\\?\\\\n/;\n\n/**\n * @alpha\n */\nexport interface FileHeaderPolicyConfig {\n\t/**\n\t * The text to use as the header.\n\t */\n\theaderText: string;\n\n\t/**\n\t * An optional string that will be appended to the headerText.\n\t */\n\tautoGenText?: string;\n}\n\n/**\n * @alpha\n */\nexport interface FileHeaderGeneratorConfig\n\textends Partial<FileHeaderPolicyConfig> {\n\tmatch: RegExp;\n\n\t/**\n\t * Regex matching header prefix (e.g. `/*!\\r?\\n`)\n\t */\n\theaderStart?: RegExp;\n\n\t/**\n\t * Regex matching beginning of each line (e.g. ' * ')\n\t */\n\tlineStart: RegExp;\n\n\t/**\n\t * Regex matching the end of each line (e.g., `\\r?\\n`)\n\t */\n\tlineEnd: RegExp;\n\n\t/**\n\t * Regex matching the header postfix.\n\t */\n\theaderEnd?: RegExp;\n\n\treplacer: (content: string, config: FileHeaderPolicyConfig) => string;\n}\n\n/**\n * Given a {@link FileHeaderPolicyConfig}, produces a function that detects correct file headers\n * and returns an error string if the header is missing or incorrect.\n *\n * @alpha\n */\nexport function defineFileHeaderPolicy(\n\tname: string,\n\tconfig: FileHeaderGeneratorConfig,\n): PolicyDefinition<FileHeaderPolicyConfig> {\n\tconst pre = config.headerStart?.source ?? \"\";\n\tconst start = config.lineStart.source;\n\tconst end = config.lineEnd.source;\n\tconst post = config.headerEnd?.source ?? \"\";\n\n\t// Helper which constructs a matching RegExp from a given multiline string.\n\t// (See https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Regular_Expressions#escaping)\n\tconst toRegex = (text: string): string =>\n\t\ttext\n\t\t\t.split(newline)\n\t\t\t.map(\n\t\t\t\t(line) =>\n\t\t\t\t\t`${start}${line.replace(/[$()*+.?[\\\\\\]^{|}]/g, \"\\\\$&\")}${end}`,\n\t\t\t)\n\t\t\t.join(\"\")\n\t\t\t.replace(trailingSpaces, \"\\\\r?\\\\n\"); // Trim trailing spaces at end-of-line.\n\n\t// Detection regex matches the header start (if any), followed by lines in 'headerText',\n\t// optionally followed by lines in the 'autoGenText', and finally the header end (if any).\n\tconst regex = new RegExp(\n\t\t`^${pre}${toRegex(config.headerText ?? \"\")}(${toRegex(config.autoGenText ?? \"\")})?${post}`,\n\t);\n\n\treturn {\n\t\tname,\n\t\tmatch: config.match,\n\t\thandler: async ({ file, resolve, config: policyConfig }) => {\n\t\t\tif (policyConfig === undefined) {\n\t\t\t\treturn true;\n\t\t\t}\n\n\t\t\tconst failResult: PolicyFailure = {\n\t\t\t\tname,\n\t\t\t\tfile,\n\t\t\t\tautoFixable: true,\n\t\t\t\terrorMessages: [],\n\t\t\t};\n\n\t\t\t// TODO: Consider reading only the first 512B or so since headers are typically\n\t\t\t// at the beginning of the file.\n\t\t\tconst content = await readFile(file, { encoding: \"utf8\" });\n\t\t\tconst failed = !regex.test(content);\n\n\t\t\tif (failed) {\n\t\t\t\tfailResult.errorMessages.push(`${extname(file)} file missing header`);\n\t\t\t}\n\n\t\t\tif (failed) {\n\t\t\t\tif (resolve) {\n\t\t\t\t\tconst newContent = config.replacer(content, policyConfig);\n\t\t\t\t\tawait writeFile(file, newContent);\n\n\t\t\t\t\tconst fixResult: PolicyFixResult = {\n\t\t\t\t\t\t...failResult,\n\t\t\t\t\t\tresolved: true,\n\t\t\t\t\t};\n\n\t\t\t\t\treturn fixResult;\n\t\t\t\t}\n\t\t\t\treturn failResult;\n\t\t\t}\n\n\t\t\treturn true;\n\t\t},\n\t};\n}\n"]}

package/esm/policyDefiners/definePackagePolicy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"definePackagePolicy.d.ts","sourceRoot":"","sources":["../../src/policyDefiners/definePackagePolicy.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE7C,OAAO,KAAK,EACX,gBAAgB,EAChB,uBAAuB,EACvB,mBAAmB,EACnB,MAAM,cAAc,CAAC;AAItB;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,EAAE,CAAC,IAAI,CACtC,IAAI,EAAE,CAAC,EACP,IAAI,EAAE,uBAAuB,CAAC,CAAC,CAAC,KAC5B,OAAO,CAAC,mBAAmB,CAAC,CAAC;AAElC;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,GAAG,WAAW,EAAE,CAAC,GAAG,SAAS,EACjE,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,GAErC,gBAAgB,CAAC,CAAC,CAAC,CAUrB"}
+{"version":3,"file":"definePackagePolicy.d.ts","sourceRoot":"","sources":["../../src/policyDefiners/definePackagePolicy.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE7C,OAAO,KAAK,EACX,gBAAgB,EAChB,uBAAuB,EACvB,mBAAmB,EACnB,MAAM,cAAc,CAAC;AAItB;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,EAAE,CAAC,IAAI,CACtC,IAAI,EAAE,CAAC,EACP,IAAI,EAAE,uBAAuB,CAAC,CAAC,CAAC,KAC5B,OAAO,CAAC,mBAAmB,CAAC,CAAC;AAElC;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,GAAG,WAAW,EAAE,CAAC,GAAG,SAAS,EACjE,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,GAErC,gBAAgB,CAAC,CAAC,CAAC,CAUrB"}

package/esm/policyDefiners/definePackagePolicy.js

@@ -1,4 +1,5 @@
 import jsonfile from "jsonfile";
+import { resolve } from "pathe";
 import { PackageJsonRegexMatch } from "../policies/constants.js";
 const { readFile: readJson } = jsonfile;
 /**
@@ -12,7 +13,7 @@ export function definePackagePolicy(name, packagePolicy) {
         name,
         match: PackageJsonRegexMatch,
         handler: async (innerArgs) => {
-            const json = await readJson(innerArgs.file);
+            const json = await readJson(resolve(innerArgs.root, innerArgs.file));
             return packagePolicy(json, innerArgs);
         },
     };

package/esm/policyDefiners/definePackagePolicy.js.map

@@ -1 +1 @@
-{"version":3,"file":"definePackagePolicy.js","sourceRoot":"","sources":["../../src/policyDefiners/definePackagePolicy.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,UAAU,CAAC;AAEhC,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAOjE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,QAAQ,CAAC;AAYxC;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAClC,IAAY,EACZ,aAAuC;IAGvC,0CAA0C;IAC1C,OAAO;QACN,IAAI;QACJ,KAAK,EAAE,qBAAqB;QAC5B,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE;YAC5B,MAAM,IAAI,GAAM,MAAM,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAC/C,OAAO,aAAa,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QACvC,CAAC;KACD,CAAC;AACH,CAAC","sourcesContent":["import jsonfile from \"jsonfile\";\nimport type { PackageJson } from \"type-fest\";\nimport { PackageJsonRegexMatch } from \"../policies/constants.js\";\nimport type {\n\tPolicyDefinition,\n\tPolicyFunctionArguments,\n\tPolicyHandlerResult,\n} from \"../policy.js\";\n\nconst { readFile: readJson } = jsonfile;\n\n/**\n * A policy handler especially for policies that target package.json.\n *\n * @alpha\n */\nexport type PackageJsonHandler<J, C> = (\n\tjson: J,\n\targs: PolicyFunctionArguments<C>,\n) => Promise<PolicyHandlerResult>;\n\n/**\n * Define a repo policy for package.json files.\n *\n * @alpha\n */\nexport function definePackagePolicy<J = PackageJson, C = undefined>(\n\tname: string,\n\tpackagePolicy: PackageJsonHandler<J, C>,\n\t// args: PolicyFunctionArguments<C>,\n): PolicyDefinition<C> {\n\t// const func = () => handler(json, args);\n\treturn {\n\t\tname,\n\t\tmatch: PackageJsonRegexMatch,\n\t\thandler: async (innerArgs) => {\n\t\t\tconst json: J = await readJson(innerArgs.file);\n\t\t\treturn packagePolicy(json, innerArgs);\n\t\t},\n\t};\n}\n"]}
+{"version":3,"file":"definePackagePolicy.js","sourceRoot":"","sources":["../../src/policyDefiners/definePackagePolicy.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,UAAU,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAEhC,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAOjE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,QAAQ,CAAC;AAYxC;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAClC,IAAY,EACZ,aAAuC;IAGvC,0CAA0C;IAC1C,OAAO;QACN,IAAI;QACJ,KAAK,EAAE,qBAAqB;QAC5B,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE;YAC5B,MAAM,IAAI,GAAM,MAAM,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;YACxE,OAAO,aAAa,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QACvC,CAAC;KACD,CAAC;AACH,CAAC","sourcesContent":["import jsonfile from \"jsonfile\";\nimport { resolve } from \"pathe\";\nimport type { PackageJson } from \"type-fest\";\nimport { PackageJsonRegexMatch } from \"../policies/constants.js\";\nimport type {\n\tPolicyDefinition,\n\tPolicyFunctionArguments,\n\tPolicyHandlerResult,\n} from \"../policy.js\";\n\nconst { readFile: readJson } = jsonfile;\n\n/**\n * A policy handler especially for policies that target package.json.\n *\n * @alpha\n */\nexport type PackageJsonHandler<J, C> = (\n\tjson: J,\n\targs: PolicyFunctionArguments<C>,\n) => Promise<PolicyHandlerResult>;\n\n/**\n * Define a repo policy for package.json files.\n *\n * @alpha\n */\nexport function definePackagePolicy<J = PackageJson, C = undefined>(\n\tname: string,\n\tpackagePolicy: PackageJsonHandler<J, C>,\n\t// args: PolicyFunctionArguments<C>,\n): PolicyDefinition<C> {\n\t// const func = () => handler(json, args);\n\treturn {\n\t\tname,\n\t\tmatch: PackageJsonRegexMatch,\n\t\thandler: async (innerArgs) => {\n\t\t\tconst json: J = await readJson(resolve(innerArgs.root, innerArgs.file));\n\t\t\treturn packagePolicy(json, innerArgs);\n\t\t},\n\t};\n}\n"]}

package/esm/tsdoc-metadata.json

@@ -5,7 +5,7 @@
   "toolPackages": [
     {
       "packageName": "@microsoft/api-extractor",
-      "packageVersion": "7.54.0"
+      "packageVersion": "7.55.1"
     }
   ]
 }

package/esm/utils/indentation.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Represents detected indentation style.
+ *
+ * - `"\t"` - Tab character
+ * - `number` - Number of spaces (e.g., 2, 4)
+ */
+export type IndentationStyle = "\t" | number;
+/**
+ * Default indentation style used when detection fails or no indentation is found.
+ *
+ * @alpha
+ */
+export declare const DEFAULT_INDENTATION: IndentationStyle;
+/**
+ * Detect the indentation style used in a file.
+ *
+ * Analyzes the file content to determine whether tabs or spaces are used
+ * for indentation. This is useful when writing files to preserve
+ * the existing formatting style.
+ *
+ * @param filePath - Path to the file
+ * @param defaultIndentation - Indentation to use if detection fails (default: tab)
+ * @returns The detected indentation (tab character or number of spaces)
+ *
+ * @example
+ * ```typescript
+ * const indent = await detectIndentation("/path/to/package.json");
+ * // Returns "\t" for tabs, or a number like 2 or 4 for spaces
+ *
+ * // With custom default
+ * const indent = await detectIndentation("/path/to/file.yaml", 2);
+ * ```
+ *
+ * @alpha
+ */
+export declare function detectIndentation(filePath: string, defaultIndentation?: IndentationStyle): Promise<IndentationStyle>;
+/**
+ * Detect the indentation style used in text content.
+ *
+ * Analyzes the content string to determine whether tabs or spaces are used
+ * for indentation. This is a pure function useful for testing and for
+ * cases where the content is already in memory.
+ *
+ * The detection algorithm:
+ * 1. Splits content into lines
+ * 2. Finds the first line that starts with whitespace
+ * 3. If it starts with a tab, returns tab
+ * 4. If it starts with spaces, returns the count of leading spaces
+ * 5. If no indented lines found, returns the default
+ *
+ * @param content - The file content as a string
+ * @param defaultIndentation - Indentation to use if no indented lines found (default: tab)
+ * @returns The detected indentation (tab character or number of spaces)
+ *
+ * @example
+ * ```typescript
+ * // JSON with 2-space indentation
+ * const json = '{\n  "name": "test"\n}';
+ * detectIndentationFromContent(json); // Returns 2
+ *
+ * // YAML with tab indentation
+ * const yaml = 'root:\n\tchild: value';
+ * detectIndentationFromContent(yaml); // Returns "\t"
+ *
+ * // No indentation found - uses default
+ * detectIndentationFromContent('no indent'); // Returns "\t"
+ * detectIndentationFromContent('no indent', 4); // Returns 4
+ * ```
+ *
+ * @alpha
+ */
+export declare function detectIndentationFromContent(content: string, defaultIndentation?: IndentationStyle): IndentationStyle;
+//# sourceMappingURL=indentation.d.ts.map

package/esm/utils/indentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indentation.d.ts","sourceRoot":"","sources":["../../src/utils/indentation.ts"],"names":[],"mappings":"AAOA;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,IAAI,GAAG,MAAM,CAAC;AAE7C;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,gBAAuB,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,iBAAiB,CACtC,QAAQ,EAAE,MAAM,EAChB,kBAAkB,GAAE,gBAAsC,GACxD,OAAO,CAAC,gBAAgB,CAAC,CAQ3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,4BAA4B,CAC3C,OAAO,EAAE,MAAM,EACf,kBAAkB,GAAE,gBAAsC,GACxD,gBAAgB,CAmBlB"}

package/esm/utils/indentation.js

@@ -0,0 +1,97 @@
+import { readFile } from "node:fs/promises";
+/**
+ * Regex to match leading whitespace at the start of a line.
+ */
+const LEADING_WHITESPACE_REGEX = /^(\s+)/;
+/**
+ * Default indentation style used when detection fails or no indentation is found.
+ *
+ * @alpha
+ */
+export const DEFAULT_INDENTATION = "\t";
+/**
+ * Detect the indentation style used in a file.
+ *
+ * Analyzes the file content to determine whether tabs or spaces are used
+ * for indentation. This is useful when writing files to preserve
+ * the existing formatting style.
+ *
+ * @param filePath - Path to the file
+ * @param defaultIndentation - Indentation to use if detection fails (default: tab)
+ * @returns The detected indentation (tab character or number of spaces)
+ *
+ * @example
+ * ```typescript
+ * const indent = await detectIndentation("/path/to/package.json");
+ * // Returns "\t" for tabs, or a number like 2 or 4 for spaces
+ *
+ * // With custom default
+ * const indent = await detectIndentation("/path/to/file.yaml", 2);
+ * ```
+ *
+ * @alpha
+ */
+export async function detectIndentation(filePath, defaultIndentation = DEFAULT_INDENTATION) {
+    try {
+        const content = await readFile(filePath, "utf-8");
+        return detectIndentationFromContent(content, defaultIndentation);
+    }
+    catch {
+        // If we can't read the file, use default
+        return defaultIndentation;
+    }
+}
+/**
+ * Detect the indentation style used in text content.
+ *
+ * Analyzes the content string to determine whether tabs or spaces are used
+ * for indentation. This is a pure function useful for testing and for
+ * cases where the content is already in memory.
+ *
+ * The detection algorithm:
+ * 1. Splits content into lines
+ * 2. Finds the first line that starts with whitespace
+ * 3. If it starts with a tab, returns tab
+ * 4. If it starts with spaces, returns the count of leading spaces
+ * 5. If no indented lines found, returns the default
+ *
+ * @param content - The file content as a string
+ * @param defaultIndentation - Indentation to use if no indented lines found (default: tab)
+ * @returns The detected indentation (tab character or number of spaces)
+ *
+ * @example
+ * ```typescript
+ * // JSON with 2-space indentation
+ * const json = '{\n  "name": "test"\n}';
+ * detectIndentationFromContent(json); // Returns 2
+ *
+ * // YAML with tab indentation
+ * const yaml = 'root:\n\tchild: value';
+ * detectIndentationFromContent(yaml); // Returns "\t"
+ *
+ * // No indentation found - uses default
+ * detectIndentationFromContent('no indent'); // Returns "\t"
+ * detectIndentationFromContent('no indent', 4); // Returns 4
+ * ```
+ *
+ * @alpha
+ */
+export function detectIndentationFromContent(content, defaultIndentation = DEFAULT_INDENTATION) {
+    const lines = content.split("\n");
+    // Look for the first indented line to detect the pattern
+    for (const line of lines) {
+        const match = LEADING_WHITESPACE_REGEX.exec(line);
+        if (match?.[1]) {
+            const indent = match[1];
+            // Check if it's tabs
+            if (indent.startsWith("\t")) {
+                return "\t";
+            }
+            // Count spaces
+            return indent.length;
+        }
+    }
+    // No indented lines found, use default
+    return defaultIndentation;
+}
+//# sourceMappingURL=indentation.js.map

package/esm/utils/indentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"indentation.js","sourceRoot":"","sources":["../../src/utils/indentation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C;;GAEG;AACH,MAAM,wBAAwB,GAAG,QAAQ,CAAC;AAU1C;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAqB,IAAI,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACtC,QAAgB,EAChB,qBAAuC,mBAAmB;IAE1D,IAAI,CAAC;QACJ,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAClD,OAAO,4BAA4B,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC;IAClE,CAAC;IAAC,MAAM,CAAC;QACR,yCAAyC;QACzC,OAAO,kBAAkB,CAAC;IAC3B,CAAC;AACF,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,UAAU,4BAA4B,CAC3C,OAAe,EACf,qBAAuC,mBAAmB;IAE1D,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAElC,yDAAyD;IACzD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAG,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClD,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAChB,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACxB,qBAAqB;YACrB,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC7B,OAAO,IAAI,CAAC;YACb,CAAC;YACD,eAAe;YACf,OAAO,MAAM,CAAC,MAAM,CAAC;QACtB,CAAC;IACF,CAAC;IAED,uCAAuC;IACvC,OAAO,kBAAkB,CAAC;AAC3B,CAAC","sourcesContent":["import { readFile } from \"node:fs/promises\";\n\n/**\n * Regex to match leading whitespace at the start of a line.\n */\nconst LEADING_WHITESPACE_REGEX = /^(\\s+)/;\n\n/**\n * Represents detected indentation style.\n *\n * - `\"\\t\"` - Tab character\n * - `number` - Number of spaces (e.g., 2, 4)\n */\nexport type IndentationStyle = \"\\t\" | number;\n\n/**\n * Default indentation style used when detection fails or no indentation is found.\n *\n * @alpha\n */\nexport const DEFAULT_INDENTATION: IndentationStyle = \"\\t\";\n\n/**\n * Detect the indentation style used in a file.\n *\n * Analyzes the file content to determine whether tabs or spaces are used\n * for indentation. This is useful when writing files to preserve\n * the existing formatting style.\n *\n * @param filePath - Path to the file\n * @param defaultIndentation - Indentation to use if detection fails (default: tab)\n * @returns The detected indentation (tab character or number of spaces)\n *\n * @example\n * ```typescript\n * const indent = await detectIndentation(\"/path/to/package.json\");\n * // Returns \"\\t\" for tabs, or a number like 2 or 4 for spaces\n *\n * // With custom default\n * const indent = await detectIndentation(\"/path/to/file.yaml\", 2);\n * ```\n *\n * @alpha\n */\nexport async function detectIndentation(\n\tfilePath: string,\n\tdefaultIndentation: IndentationStyle = DEFAULT_INDENTATION,\n): Promise<IndentationStyle> {\n\ttry {\n\t\tconst content = await readFile(filePath, \"utf-8\");\n\t\treturn detectIndentationFromContent(content, defaultIndentation);\n\t} catch {\n\t\t// If we can't read the file, use default\n\t\treturn defaultIndentation;\n\t}\n}\n\n/**\n * Detect the indentation style used in text content.\n *\n * Analyzes the content string to determine whether tabs or spaces are used\n * for indentation. This is a pure function useful for testing and for\n * cases where the content is already in memory.\n *\n * The detection algorithm:\n * 1. Splits content into lines\n * 2. Finds the first line that starts with whitespace\n * 3. If it starts with a tab, returns tab\n * 4. If it starts with spaces, returns the count of leading spaces\n * 5. If no indented lines found, returns the default\n *\n * @param content - The file content as a string\n * @param defaultIndentation - Indentation to use if no indented lines found (default: tab)\n * @returns The detected indentation (tab character or number of spaces)\n *\n * @example\n * ```typescript\n * // JSON with 2-space indentation\n * const json = '{\\n  \"name\": \"test\"\\n}';\n * detectIndentationFromContent(json); // Returns 2\n *\n * // YAML with tab indentation\n * const yaml = 'root:\\n\\tchild: value';\n * detectIndentationFromContent(yaml); // Returns \"\\t\"\n *\n * // No indentation found - uses default\n * detectIndentationFromContent('no indent'); // Returns \"\\t\"\n * detectIndentationFromContent('no indent', 4); // Returns 4\n * ```\n *\n * @alpha\n */\nexport function detectIndentationFromContent(\n\tcontent: string,\n\tdefaultIndentation: IndentationStyle = DEFAULT_INDENTATION,\n): IndentationStyle {\n\tconst lines = content.split(\"\\n\");\n\n\t// Look for the first indented line to detect the pattern\n\tfor (const line of lines) {\n\t\tconst match = LEADING_WHITESPACE_REGEX.exec(line);\n\t\tif (match?.[1]) {\n\t\t\tconst indent = match[1];\n\t\t\t// Check if it's tabs\n\t\t\tif (indent.startsWith(\"\\t\")) {\n\t\t\t\treturn \"\\t\";\n\t\t\t}\n\t\t\t// Count spaces\n\t\t\treturn indent.length;\n\t\t}\n\t}\n\n\t// No indented lines found, use default\n\treturn defaultIndentation;\n}\n"]}

package/esm/utils/packageName.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Utility functions for working with npm package names.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Result of parsing a package name into its components.
+ *
+ * @alpha
+ */
+export interface ParsedPackageName {
+    /**
+     * The full original package name.
+     */
+    name: string;
+    /**
+     * The scope portion of the name (e.g., `@myorg`), or `undefined` if unscoped.
+     */
+    scope: string | undefined;
+    /**
+     * The name portion without the scope (e.g., `my-package`).
+     * For unscoped packages, this is the same as `name`.
+     */
+    unscopedName: string;
+}
+/**
+ * Parse a package name into its scope and unscoped name components.
+ *
+ * @param packageName - The package name to parse (e.g., `@myorg/my-package` or `my-package`)
+ * @returns An object containing the parsed components
+ *
+ * @example
+ * ```typescript
+ * parsePackageName("@myorg/my-package")
+ * // Returns: { name: "@myorg/my-package", scope: "@myorg", unscopedName: "my-package" }
+ *
+ * parsePackageName("my-package")
+ * // Returns: { name: "my-package", scope: undefined, unscopedName: "my-package" }
+ * ```
+ *
+ * @alpha
+ */
+export declare function parsePackageName(packageName: string): ParsedPackageName;
+/**
+ * Extract just the scope from a package name.
+ *
+ * @param packageName - The package name (e.g., `@myorg/foo` or `unscoped-pkg`)
+ * @returns The scope (e.g., `@myorg`) or `undefined` if unscoped
+ *
+ * @alpha
+ */
+export declare function getPackageScope(packageName: string): string | undefined;
+/**
+ * Extract the unscoped portion of a package name.
+ *
+ * @param packageName - The package name (e.g., `@myorg/my-package` or `my-package`)
+ * @returns The unscoped name (e.g., `my-package`)
+ *
+ * @alpha
+ */
+export declare function getUnscopedName(packageName: string): string;
+/**
+ * Check if a package name is scoped.
+ *
+ * @param packageName - The package name to check
+ * @returns `true` if the package is scoped (starts with `@` and contains `/`)
+ *
+ * @alpha
+ */
+export declare function isScoped(packageName: string): boolean;
+//# sourceMappingURL=packageName.d.ts.map

package/esm/utils/packageName.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"packageName.d.ts","sourceRoot":"","sources":["../../src/utils/packageName.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IACjC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAE1B;;;OAGG;IACH,YAAY,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,iBAAiB,CAwBvE;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEvE;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAErD"}

package/esm/utils/packageName.js

@@ -0,0 +1,79 @@
+/**
+ * Utility functions for working with npm package names.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Parse a package name into its scope and unscoped name components.
+ *
+ * @param packageName - The package name to parse (e.g., `@myorg/my-package` or `my-package`)
+ * @returns An object containing the parsed components
+ *
+ * @example
+ * ```typescript
+ * parsePackageName("@myorg/my-package")
+ * // Returns: { name: "@myorg/my-package", scope: "@myorg", unscopedName: "my-package" }
+ *
+ * parsePackageName("my-package")
+ * // Returns: { name: "my-package", scope: undefined, unscopedName: "my-package" }
+ * ```
+ *
+ * @alpha
+ */
+export function parsePackageName(packageName) {
+    if (!packageName.startsWith("@")) {
+        return {
+            name: packageName,
+            scope: undefined,
+            unscopedName: packageName,
+        };
+    }
+    const slashIndex = packageName.indexOf("/");
+    if (slashIndex === -1) {
+        // Malformed scoped name without a slash - treat as unscoped
+        return {
+            name: packageName,
+            scope: undefined,
+            unscopedName: packageName,
+        };
+    }
+    return {
+        name: packageName,
+        scope: packageName.slice(0, slashIndex),
+        unscopedName: packageName.slice(slashIndex + 1),
+    };
+}
+/**
+ * Extract just the scope from a package name.
+ *
+ * @param packageName - The package name (e.g., `@myorg/foo` or `unscoped-pkg`)
+ * @returns The scope (e.g., `@myorg`) or `undefined` if unscoped
+ *
+ * @alpha
+ */
+export function getPackageScope(packageName) {
+    return parsePackageName(packageName).scope;
+}
+/**
+ * Extract the unscoped portion of a package name.
+ *
+ * @param packageName - The package name (e.g., `@myorg/my-package` or `my-package`)
+ * @returns The unscoped name (e.g., `my-package`)
+ *
+ * @alpha
+ */
+export function getUnscopedName(packageName) {
+    return parsePackageName(packageName).unscopedName;
+}
+/**
+ * Check if a package name is scoped.
+ *
+ * @param packageName - The package name to check
+ * @returns `true` if the package is scoped (starts with `@` and contains `/`)
+ *
+ * @alpha
+ */
+export function isScoped(packageName) {
+    return parsePackageName(packageName).scope !== undefined;
+}
+//# sourceMappingURL=packageName.js.map

package/esm/utils/packageName.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"packageName.js","sourceRoot":"","sources":["../../src/utils/packageName.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAyBH;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,gBAAgB,CAAC,WAAmB;IACnD,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAClC,OAAO;YACN,IAAI,EAAE,WAAW;YACjB,KAAK,EAAE,SAAS;YAChB,YAAY,EAAE,WAAW;SACzB,CAAC;IACH,CAAC;IAED,MAAM,UAAU,GAAG,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC5C,IAAI,UAAU,KAAK,CAAC,CAAC,EAAE,CAAC;QACvB,4DAA4D;QAC5D,OAAO;YACN,IAAI,EAAE,WAAW;YACjB,KAAK,EAAE,SAAS;YAChB,YAAY,EAAE,WAAW;SACzB,CAAC;IACH,CAAC;IAED,OAAO;QACN,IAAI,EAAE,WAAW;QACjB,KAAK,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC;QACvC,YAAY,EAAE,WAAW,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC;KAC/C,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,WAAmB;IAClD,OAAO,gBAAgB,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC;AAC5C,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,WAAmB;IAClD,OAAO,gBAAgB,CAAC,WAAW,CAAC,CAAC,YAAY,CAAC;AACnD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,QAAQ,CAAC,WAAmB;IAC3C,OAAO,gBAAgB,CAAC,WAAW,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC;AAC1D,CAAC","sourcesContent":["/**\n * Utility functions for working with npm package names.\n *\n * @packageDocumentation\n */\n\n/**\n * Result of parsing a package name into its components.\n *\n * @alpha\n */\nexport interface ParsedPackageName {\n\t/**\n\t * The full original package name.\n\t */\n\tname: string;\n\n\t/**\n\t * The scope portion of the name (e.g., `@myorg`), or `undefined` if unscoped.\n\t */\n\tscope: string | undefined;\n\n\t/**\n\t * The name portion without the scope (e.g., `my-package`).\n\t * For unscoped packages, this is the same as `name`.\n\t */\n\tunscopedName: string;\n}\n\n/**\n * Parse a package name into its scope and unscoped name components.\n *\n * @param packageName - The package name to parse (e.g., `@myorg/my-package` or `my-package`)\n * @returns An object containing the parsed components\n *\n * @example\n * ```typescript\n * parsePackageName(\"@myorg/my-package\")\n * // Returns: { name: \"@myorg/my-package\", scope: \"@myorg\", unscopedName: \"my-package\" }\n *\n * parsePackageName(\"my-package\")\n * // Returns: { name: \"my-package\", scope: undefined, unscopedName: \"my-package\" }\n * ```\n *\n * @alpha\n */\nexport function parsePackageName(packageName: string): ParsedPackageName {\n\tif (!packageName.startsWith(\"@\")) {\n\t\treturn {\n\t\t\tname: packageName,\n\t\t\tscope: undefined,\n\t\t\tunscopedName: packageName,\n\t\t};\n\t}\n\n\tconst slashIndex = packageName.indexOf(\"/\");\n\tif (slashIndex === -1) {\n\t\t// Malformed scoped name without a slash - treat as unscoped\n\t\treturn {\n\t\t\tname: packageName,\n\t\t\tscope: undefined,\n\t\t\tunscopedName: packageName,\n\t\t};\n\t}\n\n\treturn {\n\t\tname: packageName,\n\t\tscope: packageName.slice(0, slashIndex),\n\t\tunscopedName: packageName.slice(slashIndex + 1),\n\t};\n}\n\n/**\n * Extract just the scope from a package name.\n *\n * @param packageName - The package name (e.g., `@myorg/foo` or `unscoped-pkg`)\n * @returns The scope (e.g., `@myorg`) or `undefined` if unscoped\n *\n * @alpha\n */\nexport function getPackageScope(packageName: string): string | undefined {\n\treturn parsePackageName(packageName).scope;\n}\n\n/**\n * Extract the unscoped portion of a package name.\n *\n * @param packageName - The package name (e.g., `@myorg/my-package` or `my-package`)\n * @returns The unscoped name (e.g., `my-package`)\n *\n * @alpha\n */\nexport function getUnscopedName(packageName: string): string {\n\treturn parsePackageName(packageName).unscopedName;\n}\n\n/**\n * Check if a package name is scoped.\n *\n * @param packageName - The package name to check\n * @returns `true` if the package is scoped (starts with `@` and contains `/`)\n *\n * @alpha\n */\nexport function isScoped(packageName: string): boolean {\n\treturn parsePackageName(packageName).scope !== undefined;\n}\n"]}

package/oclif.manifest.json

@@ -125,5 +125,5 @@
       ]
     }
   },
-  "version": "0.7.1"
+  "version": "0.8.0"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "repopo",
-  "version": "0.7.1",
+  "version": "0.8.0",
   "description": "Enforce policies on all or some of the files in a git repository.",
   "keywords": [
     "policy",
@@ -42,46 +42,60 @@
     "/THIRD-PARTY-LICENSES.txt"
   ],
   "oclif": {
+    "additionalHelpFlags": [
+      "-h"
+    ],
+    "additionalVersionFlags": [
+      "-V"
+    ],
     "bin": "repopo",
     "commands": {
       "strategy": "pattern",
       "target": "./esm/commands"
     },
-    "devPlugins": [],
+    "devPlugins": [
+      "@oclif/plugin-command-snapshot"
+    ],
     "dirname": "repopo",
     "plugins": [],
     "repositoryPrefix": "<%- repo %>/blob/main/packages/repopo/<%- commandPath %>"
   },
   "dependencies": {
-    "@fluid-tools/build-infrastructure": "~0.60.0",
+    "@fluid-tools/build-infrastructure": "~0.63.0",
     "@oclif/core": "^4.8.0",
-    "@oclif/plugin-help": "^6.2.35",
-    "@rushstack/node-core-library": "^5.18.0",
+    "@oclif/plugin-help": "^6.2.36",
+    "@rushstack/node-core-library": "^5.19.0",
+    "consola": "^3.4.0",
     "defu": "^6.1.4",
     "jsonfile": "^6.2.0",
     "microdiff": "^1.5.0",
     "pathe": "^2.0.3",
     "picocolors": "^1.1.1",
+    "picomatch": "^4.0.3",
+    "resolve-workspace-root": "^2.0.0",
     "simple-git": "^3.30.0",
-    "@tylerbu/cli-api": "^0.9.0",
+    "tinyglobby": "^0.2.15",
+    "@tylerbu/cli-api": "^0.10.0",
     "@tylerbu/fundamentals": "^0.3.0"
   },
   "devDependencies": {
-    "@biomejs/biome": "2.2.5",
-    "@microsoft/api-extractor": "^7.54.0",
+    "@biomejs/biome": "2.3.8",
+    "@microsoft/api-extractor": "^7.55.1",
     "@oclif/plugin-command-snapshot": "^5.3.8",
-    "@oclif/test": "^4.1.14",
+    "@oclif/test": "^4.1.15",
     "@types/jsonfile": "^6.1.4",
-    "@types/node": "^20.19.24",
+    "@types/node": "^20.19.25",
+    "@types/picomatch": "^4.0.2",
     "@types/tmp": "^0.2.6",
-    "generate-license-file": "^4.1.0",
-    "oclif": "^4.22.44",
-    "rimraf": "^6.1.0",
+    "@vitest/coverage-v8": "^4.0.17",
+    "generate-license-file": "^4.1.1",
+    "oclif": "^4.22.50",
+    "rimraf": "^6.1.2",
     "tmp-promise": "^3.0.3",
     "ts-node": "^10.9.2",
-    "type-fest": "^5.2.0",
+    "type-fest": "^5.4.1",
     "typescript": "~5.9.3",
-    "vitest": "^3.2.4"
+    "vitest": "^4.0.17"
   },
   "peerDependencies": {
     "sort-package-json": "*"
@@ -120,6 +134,7 @@
     "readme:main": "oclif readme --no-aliases",
     "release:license": "generate-license-file -c ../../.generatelicensefile.cjs",
     "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
     "test:snapshots": "./bin/dev.js snapshot:compare --filepath test/commands/__snapshots__/commands.json"
   }
 }