eslint-plugin-copilot 1.0.5

package/dist/_internal/create-copilot-rule.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @packageDocumentation
+ * Shared rule creator wrapper used by eslint-plugin-copilot rules.
+ */
+import type { TSESLint } from "@typescript-eslint/utils";
+import { ESLintUtils } from "@typescript-eslint/utils";
+import type { CopilotConfigName, CopilotConfigReference } from "./copilot-config-references.js";
+/** Copilot-specific metadata extensions stored in `meta.docs`. */
+export type CopilotRuleDocs = Readonly<{
+    copilotConfigNames: readonly CopilotConfigName[];
+    copilotConfigs: CopilotConfigReference | readonly CopilotConfigReference[];
+    description: string;
+    frozen: boolean;
+    recommended: boolean;
+    requiresTypeChecking: boolean;
+    ruleId: string;
+    ruleNumber: number;
+    url: string;
+}>;
+/** Public runtime rule module shape emitted by this plugin. */
+export type CopilotRuleModule = Readonly<{
+    name: string;
+}> & TSESLint.RuleModule<string, readonly unknown[], CopilotRuleDocs>;
+type BaseRuleCreator = ReturnType<typeof ESLintUtils.RuleCreator<CopilotRuleInputDocs>>;
+/** Authored docs metadata accepted by individual rule modules. */
+type CopilotRuleInputDocs = Readonly<{
+    copilotConfigs: CopilotConfigReference | readonly CopilotConfigReference[];
+    description: string;
+    frozen: boolean;
+    recommended: boolean;
+    requiresTypeChecking: boolean;
+}>;
+declare const baseRuleCreator: BaseRuleCreator;
+/**
+ * Shared rule creator that injects canonical docs URLs and stable catalog ids.
+ */
+export declare const createCopilotRule: <Options extends readonly unknown[], MessageIds extends string>(ruleDefinition: Parameters<typeof baseRuleCreator<Options, MessageIds>>[0]) => CopilotRuleModule;
+export {};
+//# sourceMappingURL=create-copilot-rule.d.ts.map

package/dist/_internal/create-copilot-rule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-copilot-rule.d.ts","sourceRoot":"","sources":["../../src/_internal/create-copilot-rule.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEzD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvD,OAAO,KAAK,EACR,iBAAiB,EACjB,sBAAsB,EACzB,MAAM,gCAAgC,CAAC;AAKxC,kEAAkE;AAClE,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC;IACnC,kBAAkB,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACjD,cAAc,EAAE,sBAAsB,GAAG,SAAS,sBAAsB,EAAE,CAAC;IAC3E,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;IACrB,oBAAoB,EAAE,OAAO,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;CACf,CAAC,CAAC;AAEH,+DAA+D;AAC/D,MAAM,MAAM,iBAAiB,GAAG,QAAQ,CAAC;IACrC,IAAI,EAAE,MAAM,CAAC;CAChB,CAAC,GACE,QAAQ,CAAC,UAAU,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,EAAE,eAAe,CAAC,CAAC;AAErE,KAAK,eAAe,GAAG,UAAU,CAC7B,OAAO,WAAW,CAAC,WAAW,CAAC,oBAAoB,CAAC,CACvD,CAAC;AAEF,kEAAkE;AAClE,KAAK,oBAAoB,GAAG,QAAQ,CAAC;IACjC,cAAc,EAAE,sBAAsB,GAAG,SAAS,sBAAsB,EAAE,CAAC;IAC3E,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;IACrB,oBAAoB,EAAE,OAAO,CAAC;CACjC,CAAC,CAAC;AAEH,QAAA,MAAM,eAAe,EAAE,eAC6C,CAAC;AA8CrE;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAC1B,OAAO,SAAS,SAAS,OAAO,EAAE,EAClC,UAAU,SAAS,MAAM,EAEzB,gBAAgB,UAAU,CAAC,OAAO,eAAe,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,KAC3E,iBAsBF,CAAC"}

package/dist/_internal/create-copilot-rule.js

@@ -0,0 +1,56 @@
+import { ESLintUtils } from "@typescript-eslint/utils";
+import { getRuleCatalogEntryForRuleName } from "./rule-catalog.js";
+import { createRuleDocsUrl } from "./rule-docs-url.js";
+const baseRuleCreator = ESLintUtils.RuleCreator(createRuleDocsUrl);
+const getCopilotConfigNameFromReference = (reference) => {
+    switch (reference) {
+        case "copilot.configs.all": {
+            return "all";
+        }
+        case "copilot.configs.minimal": {
+            return "minimal";
+        }
+        case "copilot.configs.recommended": {
+            return "recommended";
+        }
+        case "copilot.configs.strict": {
+            return "strict";
+        }
+        default: {
+            throw new TypeError(`Unsupported Copilot config reference: ${reference}`);
+        }
+    }
+};
+/** Normalize preset references into stable preset-name keys. */
+const normalizeCopilotConfigNames = (value) => {
+    const references = Array.isArray(value) ? value : [value];
+    const normalizedNames = new Set();
+    for (const reference of references) {
+        normalizedNames.add(getCopilotConfigNameFromReference(reference));
+    }
+    return [...normalizedNames];
+};
+/**
+ * Shared rule creator that injects canonical docs URLs and stable catalog ids.
+ */
+export const createCopilotRule = (ruleDefinition) => {
+    const createdRule = baseRuleCreator(ruleDefinition);
+    const catalogEntry = getRuleCatalogEntryForRuleName(ruleDefinition.name);
+    const authoredDocs = ruleDefinition.meta.docs;
+    const docs = {
+        ...authoredDocs,
+        copilotConfigNames: normalizeCopilotConfigNames(authoredDocs.copilotConfigs),
+        ruleId: catalogEntry.ruleId,
+        ruleNumber: catalogEntry.ruleNumber,
+        url: createRuleDocsUrl(ruleDefinition.name),
+    };
+    return {
+        ...createdRule,
+        meta: {
+            ...createdRule.meta,
+            docs,
+        },
+        name: ruleDefinition.name,
+    };
+};
+//# sourceMappingURL=create-copilot-rule.js.map

package/dist/_internal/create-copilot-rule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-copilot-rule.js","sourceRoot":"","sources":["../../src/_internal/create-copilot-rule.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAOvD,OAAO,EAAE,8BAA8B,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAkCvD,MAAM,eAAe,GACjB,WAAW,CAAC,WAAW,CAAuB,iBAAiB,CAAC,CAAC;AAErE,MAAM,iCAAiC,GAAG,CACtC,SAAiC,EAChB,EAAE;IACnB,QAAQ,SAAS,EAAE,CAAC;QAChB,KAAK,qBAAqB,CAAC,CAAC,CAAC;YACzB,OAAO,KAAK,CAAC;QACjB,CAAC;QAED,KAAK,yBAAyB,CAAC,CAAC,CAAC;YAC7B,OAAO,SAAS,CAAC;QACrB,CAAC;QAED,KAAK,6BAA6B,CAAC,CAAC,CAAC;YACjC,OAAO,aAAa,CAAC;QACzB,CAAC;QAED,KAAK,wBAAwB,CAAC,CAAC,CAAC;YAC5B,OAAO,QAAQ,CAAC;QACpB,CAAC;QAED,OAAO,CAAC,CAAC,CAAC;YACN,MAAM,IAAI,SAAS,CACf,yCAAyC,SAAS,EAAE,CACvD,CAAC;QACN,CAAC;IACL,CAAC;AACL,CAAC,CAAC;AAEF,gEAAgE;AAChE,MAAM,2BAA2B,GAEG,CAChC,KAAiE,EACnE,EAAE;IACA,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC1D,MAAM,eAAe,GAAG,IAAI,GAAG,EAAqB,CAAC;IAErD,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACjC,eAAe,CAAC,GAAG,CAAC,iCAAiC,CAAC,SAAS,CAAC,CAAC,CAAC;IACtE,CAAC;IAED,OAAO,CAAC,GAAG,eAAe,CAAC,CAAC;AAChC,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAI7B,cAA0E,EACzD,EAAE;IACnB,MAAM,WAAW,GAAG,eAAe,CAAC,cAAc,CAAC,CAAC;IACpD,MAAM,YAAY,GAAG,8BAA8B,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;IACzE,MAAM,YAAY,GAAG,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC;IAC9C,MAAM,IAAI,GAAoB;QAC1B,GAAG,YAAY;QACf,kBAAkB,EAAE,2BAA2B,CAC3C,YAAY,CAAC,cAAc,CAC9B;QACD,MAAM,EAAE,YAAY,CAAC,MAAM;QAC3B,UAAU,EAAE,YAAY,CAAC,UAAU;QACnC,GAAG,EAAE,iBAAiB,CAAC,cAAc,CAAC,IAAI,CAAC;KAC9C,CAAC;IAEF,OAAO;QACH,GAAG,WAAW;QACd,IAAI,EAAE;YACF,GAAG,WAAW,CAAC,IAAI;YACnB,IAAI;SACP;QACD,IAAI,EAAE,cAAc,CAAC,IAAI;KACA,CAAC;AAClC,CAAC,CAAC"}

package/dist/_internal/customization-body.d.ts

@@ -0,0 +1,6 @@
+/** Extract the Markdown body and its absolute character offset. */
+export declare const getCustomizationBodyWithOffset: (sourceText: string) => Readonly<{
+    body: string;
+    offset: number;
+}>;
+//# sourceMappingURL=customization-body.d.ts.map

package/dist/_internal/customization-body.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"customization-body.d.ts","sourceRoot":"","sources":["../../src/_internal/customization-body.ts"],"names":[],"mappings":"AAMA,mEAAmE;AACnE,eAAO,MAAM,8BAA8B,GACvC,YAAY,MAAM,KACnB,QAAQ,CAAC;IACR,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAClB,CAQA,CAAC"}

package/dist/_internal/customization-body.js

@@ -0,0 +1,15 @@
+/**
+ * @packageDocumentation
+ * Helpers for working with Markdown customization file bodies.
+ */
+import { extractFrontmatter } from "./frontmatter.js";
+/** Extract the Markdown body and its absolute character offset. */
+export const getCustomizationBodyWithOffset = (sourceText) => {
+    const frontmatter = extractFrontmatter(sourceText);
+    const body = frontmatter?.body ?? sourceText;
+    return {
+        body,
+        offset: sourceText.length - body.length,
+    };
+};
+//# sourceMappingURL=customization-body.js.map

package/dist/_internal/customization-body.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"customization-body.js","sourceRoot":"","sources":["../../src/_internal/customization-body.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD,mEAAmE;AACnE,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAC1C,UAAkB,EAInB,EAAE;IACD,MAAM,WAAW,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;IACnD,MAAM,IAAI,GAAG,WAAW,EAAE,IAAI,IAAI,UAAU,CAAC;IAE7C,OAAO;QACH,IAAI;QACJ,MAAM,EAAE,UAAU,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM;KAC1C,CAAC;AACN,CAAC,CAAC"}

package/dist/_internal/duplicate-names.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @packageDocumentation
+ * Shared duplicate-name helpers for Copilot customization files.
+ */
+/** A named Copilot customization file paired with its normalized display name. */
+export type NamedCustomizationFile = Readonly<{
+    filePath: string;
+    name: string;
+}>;
+/** Group files by normalized name and keep only duplicate groups. */
+export declare const collectDuplicateNameGroups: (entries: readonly NamedCustomizationFile[], normalizeName: (value: string) => string) => ReadonlyMap<string, readonly NamedCustomizationFile[]>;
+//# sourceMappingURL=duplicate-names.d.ts.map

package/dist/_internal/duplicate-names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"duplicate-names.d.ts","sourceRoot":"","sources":["../../src/_internal/duplicate-names.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,kFAAkF;AAClF,MAAM,MAAM,sBAAsB,GAAG,QAAQ,CAAC;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CAChB,CAAC,CAAC;AAEH,qEAAqE;AACrE,eAAO,MAAM,0BAA0B,GACnC,SAAS,SAAS,sBAAsB,EAAE,EAC1C,eAAe,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,KACzC,WAAW,CAAC,MAAM,EAAE,SAAS,sBAAsB,EAAE,CAyBvD,CAAC"}

package/dist/_internal/duplicate-names.js

@@ -0,0 +1,24 @@
+/**
+ * @packageDocumentation
+ * Shared duplicate-name helpers for Copilot customization files.
+ */
+/** Group files by normalized name and keep only duplicate groups. */
+export const collectDuplicateNameGroups = (entries, normalizeName) => {
+    const groups = new Map();
+    for (const entry of entries) {
+        const normalizedName = normalizeName(entry.name);
+        if (normalizedName.length === 0) {
+            continue;
+        }
+        const group = groups.get(normalizedName) ?? [];
+        group.push(entry);
+        groups.set(normalizedName, group);
+    }
+    return new Map([...groups.entries()]
+        .filter(([, group]) => group.length > 1)
+        .map(([name, group]) => [
+        name,
+        group.toSorted((left, right) => left.filePath.localeCompare(right.filePath)),
+    ]));
+};
+//# sourceMappingURL=duplicate-names.js.map

package/dist/_internal/duplicate-names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"duplicate-names.js","sourceRoot":"","sources":["../../src/_internal/duplicate-names.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,qEAAqE;AACrE,MAAM,CAAC,MAAM,0BAA0B,GAAG,CACtC,OAA0C,EAC1C,aAAwC,EACc,EAAE;IACxD,MAAM,MAAM,GAAG,IAAI,GAAG,EAAoC,CAAC;IAE3D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC1B,MAAM,cAAc,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAEjD,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9B,SAAS;QACb,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;QAC/C,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClB,MAAM,CAAC,GAAG,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACtC,CAAC;IAED,OAAO,IAAI,GAAG,CACV,CAAC,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;SAChB,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;SACvC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC;QACpB,IAAI;QACJ,KAAK,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAC3B,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC,CAC9C;KACJ,CAAC,CACT,CAAC;AACN,CAAC,CAAC"}

package/dist/_internal/file-system.d.ts

@@ -0,0 +1,21 @@
+/** Normalize a path to absolute slash-separated form. */
+export declare const normalizeAbsolutePath: (filePath: string) => string;
+/** Determine whether an absolute or relative path currently exists on disk. */
+export declare const pathExists: (filePath: string) => boolean;
+/** Remove `#fragment` and `?query` suffixes from a Markdown-style path target. */
+export declare const stripPathFragmentAndQuery: (value: string) => string;
+/** Determine whether a string is a Windows absolute path such as `C:\repo`. */
+export declare const isWindowsAbsolutePath: (value: string) => boolean;
+/** Determine whether a string starts with a URI-like scheme such as `https:`. */
+export declare const hasUriScheme: (value: string) => boolean;
+/** Determine whether a path token is obviously non-relative for workspace use. */
+export declare const isNonRelativeWorkspacePath: (value: string) => boolean;
+/** Determine whether a value is a workspace-relative path-like reference. */
+export declare const isRelativeWorkspacePath: (value: string) => boolean;
+/** Resolve a workspace-relative path from the current file location. */
+export declare const resolveRelativeWorkspacePath: (currentFilePath: string, relativePath: string) => string;
+/** Resolve a repository-root-relative path token. */
+export declare const resolveRepositoryRelativePath: (repositoryRootPath: string, relativePath: string) => string;
+/** Recursively list files under a directory when it exists. */
+export declare const listFilesRecursively: (directoryPath: string, predicate?: (absoluteFilePath: string) => boolean) => readonly string[];
+//# sourceMappingURL=file-system.d.ts.map

package/dist/_internal/file-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-system.d.ts","sourceRoot":"","sources":["../../src/_internal/file-system.ts"],"names":[],"mappings":"AAUA,yDAAyD;AACzD,eAAO,MAAM,qBAAqB,GAAI,UAAU,MAAM,KAAG,MACT,CAAC;AAEjD,+EAA+E;AAC/E,eAAO,MAAM,UAAU,GAAI,UAAU,MAAM,KAAG,OACnB,CAAC;AAE5B,kFAAkF;AAClF,eAAO,MAAM,yBAAyB,GAAI,OAAO,MAAM,KAAG,MAYzD,CAAC;AAEF,+EAA+E;AAC/E,eAAO,MAAM,qBAAqB,GAAI,OAAO,MAAM,KAAG,OACT,CAAC;AAE9C,iFAAiF;AACjF,eAAO,MAAM,YAAY,GAAI,OAAO,MAAM,KAAG,OACsB,CAAC;AAEpE,kFAAkF;AAClF,eAAO,MAAM,0BAA0B,GAAI,OAAO,MAAM,KAAG,OAmB1D,CAAC;AAEF,6EAA6E;AAC7E,eAAO,MAAM,uBAAuB,GAAI,OAAO,MAAM,KAAG,OASvD,CAAC;AAEF,wEAAwE;AACxE,eAAO,MAAM,4BAA4B,GACrC,iBAAiB,MAAM,EACvB,cAAc,MAAM,KACrB,MAIE,CAAC;AAEN,qDAAqD;AACrD,eAAO,MAAM,6BAA6B,GACtC,oBAAoB,MAAM,EAC1B,cAAc,MAAM,KACrB,MAC0E,CAAC;AAE9E,+DAA+D;AAC/D,eAAO,MAAM,oBAAoB,GAC7B,eAAe,MAAM,EACrB,YAAY,CAAC,gBAAgB,EAAE,MAAM,KAAK,OAAO,KAClD,SAAS,MAAM,EAsCjB,CAAC"}

package/dist/_internal/file-system.js

@@ -0,0 +1,86 @@
+/**
+ * @packageDocumentation
+ * Shared filesystem helpers for Copilot repository rule implementations.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+const WINDOWS_ABSOLUTE_PATH_PATTERN = /^[A-Za-z]:[/\\]/u;
+const URI_SCHEME_PATTERN = /^[A-Za-z][+\-.0-9A-Za-z]*:/u;
+/** Normalize a path to absolute slash-separated form. */
+export const normalizeAbsolutePath = (filePath) => path.resolve(filePath).replaceAll("\\", "/");
+/** Determine whether an absolute or relative path currently exists on disk. */
+export const pathExists = (filePath) => fs.existsSync(filePath);
+/** Remove `#fragment` and `?query` suffixes from a Markdown-style path target. */
+export const stripPathFragmentAndQuery = (value) => {
+    const queryIndex = value.indexOf("?");
+    const fragmentIndex = value.indexOf("#");
+    const cutIndexCandidates = [queryIndex, fragmentIndex].filter((index) => index >= 0);
+    if (cutIndexCandidates.length === 0) {
+        return value;
+    }
+    return value.slice(0, Math.min(...cutIndexCandidates));
+};
+/** Determine whether a string is a Windows absolute path such as `C:\repo`. */
+export const isWindowsAbsolutePath = (value) => WINDOWS_ABSOLUTE_PATH_PATTERN.test(value);
+/** Determine whether a string starts with a URI-like scheme such as `https:`. */
+export const hasUriScheme = (value) => !isWindowsAbsolutePath(value) && URI_SCHEME_PATTERN.test(value);
+/** Determine whether a path token is obviously non-relative for workspace use. */
+export const isNonRelativeWorkspacePath = (value) => {
+    const trimmedValue = value.trim();
+    const lowercaseValue = trimmedValue.toLowerCase();
+    if (trimmedValue.length === 0 || trimmedValue.startsWith("#")) {
+        return false;
+    }
+    if (lowercaseValue.startsWith("/") ||
+        lowercaseValue.startsWith("\\") ||
+        lowercaseValue.startsWith("~/") ||
+        lowercaseValue.startsWith("~\\") ||
+        lowercaseValue.startsWith("file:")) {
+        return true;
+    }
+    return isWindowsAbsolutePath(trimmedValue);
+};
+/** Determine whether a value is a workspace-relative path-like reference. */
+export const isRelativeWorkspacePath = (value) => {
+    const trimmedValue = value.trim();
+    return (trimmedValue.length > 0 &&
+        !trimmedValue.startsWith("#") &&
+        !hasUriScheme(trimmedValue) &&
+        !isNonRelativeWorkspacePath(trimmedValue));
+};
+/** Resolve a workspace-relative path from the current file location. */
+export const resolveRelativeWorkspacePath = (currentFilePath, relativePath) => path.resolve(path.dirname(currentFilePath), stripPathFragmentAndQuery(relativePath));
+/** Resolve a repository-root-relative path token. */
+export const resolveRepositoryRelativePath = (repositoryRootPath, relativePath) => path.resolve(repositoryRootPath, stripPathFragmentAndQuery(relativePath));
+/** Recursively list files under a directory when it exists. */
+export const listFilesRecursively = (directoryPath, predicate) => {
+    if (!pathExists(directoryPath)) {
+        return [];
+    }
+    const discoveredFiles = [];
+    const pendingDirectories = [directoryPath];
+    while (pendingDirectories.length > 0) {
+        const currentDirectory = pendingDirectories.pop();
+        if (currentDirectory === undefined) {
+            continue;
+        }
+        for (const entry of fs.readdirSync(currentDirectory, {
+            withFileTypes: true,
+        })) {
+            const absoluteEntryPath = path.join(currentDirectory, entry.name);
+            if (entry.isDirectory()) {
+                pendingDirectories.push(absoluteEntryPath);
+                continue;
+            }
+            if (!entry.isFile()) {
+                continue;
+            }
+            if (predicate !== undefined && !predicate(absoluteEntryPath)) {
+                continue;
+            }
+            discoveredFiles.push(absoluteEntryPath);
+        }
+    }
+    return discoveredFiles.toSorted((left, right) => left.localeCompare(right));
+};
+//# sourceMappingURL=file-system.js.map

package/dist/_internal/file-system.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-system.js","sourceRoot":"","sources":["../../src/_internal/file-system.ts"],"names":[],"mappings":"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"}

package/dist/_internal/frontmatter.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @packageDocumentation
+ * Lightweight Markdown frontmatter helpers for Copilot customization files.
+ */
+/** Parsed frontmatter bundle extracted from the start of a Markdown document. */
+export type FrontmatterDocument = Readonly<{
+    body: string;
+    content: string;
+    fields: ReadonlyMap<string, FrontmatterField>;
+}>;
+/** Parsed frontmatter field variants supported by this plugin. */
+export type FrontmatterField = Readonly<{
+    kind: "list";
+    values: readonly string[];
+}> | Readonly<{
+    kind: "scalar";
+    value: string;
+}>;
+/** Parsed object entry from a supported nested frontmatter list block. */
+export type FrontmatterObjectListEntry = Readonly<Record<string, string>>;
+/** Parsed nested object-list groups keyed by a frontmatter subfield name. */
+export type FrontmatterObjectListGroupMap = ReadonlyMap<string, readonly FrontmatterObjectListEntry[]>;
+/** Extract top-of-file YAML frontmatter when present. */
+export declare const extractFrontmatter: (text: string) => FrontmatterDocument | null;
+/** Read a non-empty scalar frontmatter value. */
+export declare const getFrontmatterScalar: (document: FrontmatterDocument, key: string) => string | undefined;
+/** Read a non-empty list of scalar frontmatter values. */
+export declare const getFrontmatterList: (document: FrontmatterDocument, key: string) => readonly string[] | undefined;
+/** Determine whether a field exists but is empty or unparsable for our subset. */
+export declare const hasFrontmatterField: (document: FrontmatterDocument, key: string) => boolean;
+/** Read a supported YAML object-list block such as `handoffs:` entries. */
+export declare const getFrontmatterObjectList: (document: FrontmatterDocument, key: string) => readonly FrontmatterObjectListEntry[] | undefined;
+/** Read nested YAML mappings of object lists such as `hooks: Event: - ...`. */
+export declare const getFrontmatterObjectListGroups: (document: FrontmatterDocument, key: string) => FrontmatterObjectListGroupMap | undefined;
+/** Remove HTML comments before checking whether Markdown body content exists. */
+export declare const getMeaningfulMarkdownBody: (text: string) => string;
+//# sourceMappingURL=frontmatter.d.ts.map

package/dist/_internal/frontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../src/_internal/frontmatter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,iFAAiF;AACjF,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CAAC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CACjD,CAAC,CAAC;AAEH,kEAAkE;AAClE,MAAM,MAAM,gBAAgB,GACtB,QAAQ,CAAC;IACL,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B,CAAC,GACF,QAAQ,CAAC;IACL,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACjB,CAAC,CAAC;AAET,0EAA0E;AAC1E,MAAM,MAAM,0BAA0B,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAE1E,6EAA6E;AAC7E,MAAM,MAAM,6BAA6B,GAAG,WAAW,CACnD,MAAM,EACN,SAAS,0BAA0B,EAAE,CACxC,CAAC;AAuTF,yDAAyD;AACzD,eAAO,MAAM,kBAAkB,GAC3B,MAAM,MAAM,KACb,mBAAmB,GAAG,IAgCxB,CAAC;AAEF,iDAAiD;AACjD,eAAO,MAAM,oBAAoB,GAC7B,UAAU,mBAAmB,EAC7B,KAAK,MAAM,KACZ,MAAM,GAAG,SAMX,CAAC;AAEF,0DAA0D;AAC1D,eAAO,MAAM,kBAAkB,GAC3B,UAAU,mBAAmB,EAC7B,KAAK,MAAM,KACZ,SAAS,MAAM,EAAE,GAAG,SAMtB,CAAC;AAEF,kFAAkF;AAClF,eAAO,MAAM,mBAAmB,GAC5B,UAAU,mBAAmB,EAC7B,KAAK,MAAM,KACZ,OAAmC,CAAC;AAEvC,2EAA2E;AAC3E,eAAO,MAAM,wBAAwB,GACjC,UAAU,mBAAmB,EAC7B,KAAK,MAAM,KACZ,SAAS,0BAA0B,EAAE,GAAG,SAwE1C,CAAC;AAEF,+EAA+E;AAC/E,eAAO,MAAM,8BAA8B,GACvC,UAAU,mBAAmB,EAC7B,KAAK,MAAM,KACZ,6BAA6B,GAAG,SA2GlC,CAAC;AAEF,iFAAiF;AACjF,eAAO,MAAM,yBAAyB,GAAI,MAAM,MAAM,KAAG,MACvB,CAAC"}