repopo 0.7.0 → 0.8.0

package/CHANGELOG.md

@@ -1,5 +1,192 @@
 # repopo
 
+## 0.8.0
+
+### Minor Changes
+
+- **BREAKING CHANGE**: Change `PolicyFailure.errorMessage` to `errorMessages` array. _[`#552`](https://github.com/tylerbutler/tools-monorepo/pull/552) [`6b6317a`](https://github.com/tylerbutler/tools-monorepo/commit/6b6317a7be0a050dc0665a9af7b187afb1bb4b31) [@tylerbutler](https://github.com/tylerbutler)_
+
+  The `PolicyFailure` interface now uses `errorMessages: string[]` instead of `errorMessage?: string`. This allows policies to report multiple error messages per failure and provides clearer semantics.
+
+  Additionally, a new optional `manualFix?: string` property has been added to provide user guidance on how to resolve policy failures manually.
+
+  Migration:
+  - Change `errorMessage: "message"` to `errorMessages: ["message"]`
+  - For multiple messages, use `errorMessages: ["msg1", "msg2"]`
+  - When checking failures, use `errorMessages.join("\n")` instead of `errorMessage`
+
+- Add NoPrivateWorkspaceDependencies policy that prevents publishable packages from depending on private workspace packages via the `workspace:` protocol. This catches configuration issues where a public npm package would fail to install because its workspace dependencies aren't published. _[`#534`](https://github.com/tylerbutler/tools-monorepo/pull/534) [`b7e4d4b`](https://github.com/tylerbutler/tools-monorepo/commit/b7e4d4b374cae228d246b16c668ba6e55c08f3dc) [@tylerbutler](https://github.com/tylerbutler)_
+
+  The policy:
+  - Detects workspace dependencies using the `workspace:` protocol
+  - Checks if those dependencies are marked as private
+  - Reports violations for publishable packages that depend on private packages
+  - Supports configurable `checkDevDependencies` option (default: false)
+  - Uses workspace configuration (pnpm-workspace.yaml or package.json workspaces) for package discovery
+
+- Make sort-tsconfig and sort-package-json peer dependencies _[`#395`](https://github.com/tylerbutler/tools-monorepo/pull/395) [`ee059d0`](https://github.com/tylerbutler/tools-monorepo/commit/ee059d02161494c14eb6131aaf32624902fd65e4) [@tylerbutler](https://github.com/tylerbutler)_
+
+  Moves `sort-tsconfig` and `sort-package-json` from dependencies to peerDependencies, allowing consumers to control versions and reducing bundle size.
+
+- Add multiple new policies and enhance existing PackageScripts policy _[`#535`](https://github.com/tylerbutler/tools-monorepo/pull/535) [`79e19e8`](https://github.com/tylerbutler/tools-monorepo/commit/79e19e892a5b1193650cab21a4d38187c700fb01) [@tylerbutler](https://github.com/tylerbutler)_
+
+  ## New Policies
+
+  ### PackageAllowedScopes
+
+  Validates that packages use only approved npm scopes or package names, preventing accidental
+  introduction of new scopes and maintaining naming consistency.
+
+  ### PackageLicense
+
+  Ensures each package has a LICENSE file that matches the root repository LICENSE. Supports
+  auto-fixing by copying the root LICENSE to packages. By default, skips private packages.
+
+  ### PackageReadme
+
+  Validates that packages have README.md files with proper content:
+  - Ensures README exists
+  - Validates title matches package name
+  - Can require specific content (e.g., trademark notices)
+  - Supports auto-fixing by creating or updating README files
+
+  ## Enhanced PackageScripts Policy
+
+  Added powerful new validation options with a cleaner, more intuitive configuration API.
+
+  ### must (enhanced)
+
+  The `must` array now accepts either strings (script must exist, no auto-fix) or objects with
+  inline default values (script must exist, auto-fixable with the default):
+
+  ```typescript
+  must: [
+    "test", // Must exist, no auto-fix available
+    { build: "tsc" }, // Must exist, auto-fix adds "tsc" if missing
+    { lint: "biome lint ." }, // Must exist, auto-fix adds "biome lint ." if missing
+  ];
+  ```
+
+  Existing scripts with different content will pass validation - only the existence is enforced.
+
+  ### exact (new)
+
+  Scripts that must exist AND have exact content. Both missing and mismatched scripts are
+  auto-fixable:
+
+  ```typescript
+  exact: {
+    clean: "rimraf dist esm",
+    format: "biome format --write .",
+  }
+  ```
+
+  ### conditionalRequired (enhanced)
+
+  Enforce that certain scripts must exist when other scripts are present. The `requires` field
+  now accepts the same format as `must` - strings or objects with inline defaults for auto-fix:
+
+  ```typescript
+  // With inline default - auto-fixable
+  conditionalRequired: [
+    { ifPresent: "build", requires: [{ clean: "rimraf dist" }] },
+  ];
+
+  // Mixed: "test" required without default, "clean" with default
+  conditionalRequired: [
+    { ifPresent: "build", requires: ["test", { clean: "rimraf dist" }] },
+  ];
+  ```
+
+  ### scriptMustContain
+
+  Validate that script bodies contain required substrings:
+
+  ```typescript
+  scriptMustContain: [{ script: "clean", mustContain: ["rimraf"] }];
+  ```
+
+  ## Usage Examples
+
+  ```typescript
+  import { makePolicy, type RepopoConfig } from "repopo";
+  import {
+    PackageAllowedScopes,
+    PackageLicense,
+    PackageReadme,
+    PackageScripts,
+  } from "repopo/policies";
+
+  const config: RepopoConfig = {
+    policies: [
+      makePolicy(PackageAllowedScopes, {
+        allowedScopes: ["@myorg", "@internal"],
+      }),
+      makePolicy(PackageLicense),
+      makePolicy(PackageReadme, {
+        requiredContent: "## Trademark",
+      }),
+      makePolicy(PackageScripts, {
+        // Scripts that must exist
+        must: [
+          "test", // Must exist, no auto-fix
+          { build: "tsc" }, // Must exist, auto-fix available
+          { lint: "biome lint ." }, // Must exist, auto-fix available
+        ],
+        // Scripts that must exist AND match exactly
+        exact: {
+          clean: "rimraf dist esm",
+          format: "biome format --write .",
+        },
+        // If "build" exists, "clean" must also exist (with inline auto-fix default)
+        conditionalRequired: [
+          { ifPresent: "build", requires: [{ clean: "rimraf dist" }] },
+        ],
+        // Validate script content contains required substrings
+        scriptMustContain: [{ script: "build", mustContain: ["tsc"] }],
+        // Only one of these can exist
+        mutuallyExclusive: [["lint:eslint", "lint:biome"]],
+      }),
+    ],
+  };
+  ```
+
+### Patch Changes
+
+- Update to use new cli-api logger API _[`#395`](https://github.com/tylerbutler/tools-monorepo/pull/395) [`ee059d0`](https://github.com/tylerbutler/tools-monorepo/commit/ee059d02161494c14eb6131aaf32624902fd65e4) [@tylerbutler](https://github.com/tylerbutler)_
+
+  Updates commands to use the new logger API from @tylerbu/cli-api:
+  - Replace `errorLog()` calls with `logError()`
+  - Use standalone `logIndent()` function where needed
+
+<details><summary>Updated 1 dependency</summary>
+
+<small>
+
+[`ee059d0`](https://github.com/tylerbutler/tools-monorepo/commit/ee059d02161494c14eb6131aaf32624902fd65e4)
+
+</small>
+
+- `@tylerbu/cli-api@0.10.0`
+
+</details>
+
+## 0.7.1
+
+### Patch Changes
+
+<details><summary>Updated 1 dependency</summary>
+
+<small>
+
+[`8832369`](https://github.com/tylerbutler/tools-monorepo/commit/8832369318b6efee8adae1636f3629639b0d76ac)
+
+</small>
+
+- `@tylerbu/cli-api@0.9.0`
+
+</details>
+
 ## 0.7.0
 
 ### Minor Changes
@@ -7,7 +194,6 @@
 - Add configurable PackageScripts policy _[`#376`](https://github.com/tylerbutler/tools-monorepo/pull/376) [`c17462a`](https://github.com/tylerbutler/tools-monorepo/commit/c17462a8af35a8bfbb528f29825a0ef177923946) [@tylerbutler](https://github.com/tylerbutler)_
 
   Enhances the `PackageScripts` policy with flexible configuration options to enforce package.json script requirements across your repository. The policy now supports two validation modes:
-
   1.  **Required Scripts (`must`)**: Specify scripts that must be present in all package.json files
   2.  **Mutually Exclusive Scripts (`mutuallyExclusive`)**: Define groups of scripts where exactly one from each group must exist
 
@@ -23,7 +209,6 @@
   ```
 
   The policy validates that:
-
   - All scripts in the `must` array are present
   - For each group in `mutuallyExclusive`, exactly one script from that group exists (not zero, not multiple)
 
@@ -32,7 +217,6 @@
 - New built-in policies _[`#308`](https://github.com/tylerbutler/tools-monorepo/pull/308) [`1856d58`](https://github.com/tylerbutler/tools-monorepo/commit/1856d582fb92692447b02c89cdb45dcd3c5f7370) [@tylerbutler](https://github.com/tylerbutler)_
 
   Added three new policies for repository quality and safety:
-
   - **LicenseFileExists**: Ensures a LICENSE file exists in the repository root (essential for open source projects)
   - **NoLargeBinaryFiles**: Prevents large binary files from being committed (default 10MB max, suggests Git LFS for large assets)
   - **RequiredGitignorePatterns**: Validates .gitignore contains required patterns to prevent committing sensitive files, dependencies, and build artifacts (auto-fixable)
@@ -96,18 +280,15 @@
   repopo now exports all included policies individually so users can opt in and out of them in their config.
 
 - New policies _[`#31`](https://github.com/tylerbutler/tools-monorepo/pull/31) [`c97a565`](https://github.com/tylerbutler/tools-monorepo/commit/c97a56518d9726667531aa71de9445fed8d56b96) [@tylerbutler](https://github.com/tylerbutler)_
-
   - JsTsFileHeaders
   - HtmlFileHeaders
   - PackageScripts
 
 - API changes: _[`#120`](https://github.com/tylerbutler/tools-monorepo/pull/120) [`1108950`](https://github.com/tylerbutler/tools-monorepo/commit/1108950a7732dcc3ac9b8da10bd014bfec6c45b7) [@tylerbutler](https://github.com/tylerbutler)_
-
   - **Breaking change**: `PolicyConfig` was renamed to `RepopoConfig`.
   - **Breaking change**: Removed several flags from the check command.
 
   Other changes:
-
   - Refactor check command for clarity (more to do)
 
 - Functions to more easily create package.json handlers _[`#190`](https://github.com/tylerbutler/tools-monorepo/pull/190) [`84c4185`](https://github.com/tylerbutler/tools-monorepo/commit/84c4185e76186c3489a4b70e3a3015ba289df139) [@tylerbutler](https://github.com/tylerbutler)_

package/THIRD-PARTY-LICENSES.txt

@@ -27,7 +27,7 @@ OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHE
 
 The following npm package may be included in this product:
 
- - @rushstack/node-core-library@5.18.0
+ - @rushstack/node-core-library@5.19.0
 
 This package contains the following license:
 
@@ -60,7 +60,37 @@ WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 
 The following npm package may be included in this product:
 
- - @fluid-tools/build-infrastructure@0.60.0
+ - resolve-workspace-root@2.0.0
+
+This package contains the following license:
+
+# The MIT License (MIT)
+
+Copyright (c) 2024-present Cedric van Putten <me@cedric.dev>
+
+> Permission is hereby granted, free of charge, to any person obtaining a copy
+> of this software and associated documentation files (the "Software"), to deal
+> in the Software without restriction, including without limitation the rights
+> to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+> copies of the Software, and to permit persons to whom the Software is
+> furnished to do so, subject to the following conditions:
+>
+> The above copyright notice and this permission notice shall be included in
+> all copies or substantial portions of the Software.
+>
+> THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+> IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+> FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+> AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+> LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+> OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+> THE SOFTWARE.
+
+-----------
+
+The following npm package may be included in this product:
+
+ - @fluid-tools/build-infrastructure@0.63.0
 
 This package contains the following license:
 
@@ -125,7 +155,7 @@ MIT
 The following npm packages may be included in this product:
 
  - @oclif/core@4.8.0
- - @oclif/plugin-help@6.2.35
+ - @oclif/plugin-help@6.2.36
 
 These packages each contain the following license:
 
@@ -183,6 +213,36 @@ SOFTWARE.
 
 -----------
 
+The following npm package may be included in this product:
+
+ - tinyglobby@0.2.15
+
+This package contains the following license:
+
+MIT License
+
+Copyright (c) 2024 Madeline Gurriarán
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+-----------
+
 The following npm package may be included in this product:
 
  - defu@6.1.4
@@ -213,6 +273,62 @@ SOFTWARE.
 
 -----------
 
+The following npm package may be included in this product:
+
+ - consola@3.4.2
+
+This package contains the following license:
+
+MIT License
+
+Copyright (c) Pooya Parsa <pooya@pi0.io>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+Prompt support is based on https://github.com/bombshell-dev/clack
+
+MIT License
+
+Copyright (c) Nate Moore
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+---
+
+Color support is based on https://github.com/jorgebucaran/colorette
+
+Copyright © Jorge Bucaran <https://jorgebucaran.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the 'Software'), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+-----------
+
 The following npm package may be included in this product:
 
  - pathe@2.0.3
@@ -292,5 +408,35 @@ DEALINGS IN THE SOFTWARE.
 
 -----------
 
+The following npm package may be included in this product:
+
+ - picomatch@4.0.3
+
+This package contains the following license:
+
+The MIT License (MIT)
+
+Copyright (c) 2017-present, Jon Schlinkert.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+
+-----------
+
 This file was generated with the generate-license-file npm package!
 https://www.npmjs.com/package/generate-license-file

package/esm/adapters/fluidFramework.d.ts

@@ -0,0 +1,103 @@
+import type { PolicyDefinition } from "../policy.js";
+/**
+ * A FluidFramework build-tools policy handler interface.
+ *
+ * This interface matches the `Handler` interface from `@fluidframework/build-tools`.
+ *
+ * @alpha
+ */
+export interface FluidHandler {
+    /**
+     * The name of the handler, used for filtering and display.
+     */
+    name: string;
+    /**
+     * A regex pattern that determines which files this handler applies to.
+     */
+    match: RegExp;
+    /**
+     * The handler function that checks a file against the policy.
+     *
+     * @param file - Absolute path to the file.
+     * @param root - Path to the repo root.
+     * @returns `undefined` if the check passes, otherwise an error message string.
+     */
+    handler: (file: string, root: string) => Promise<string | undefined>;
+    /**
+     * Optional resolver function that attempts to fix policy violations.
+     *
+     * @param file - Absolute path to the file.
+     * @param root - Path to the repo root.
+     * @returns An object indicating whether the fix was successful.
+     */
+    resolver?: (file: string, root: string) => Promise<{
+        resolved: boolean;
+        message?: string;
+    }> | {
+        resolved: boolean;
+        message?: string;
+    };
+}
+/**
+ * Options for converting FluidFramework handlers to repopo policies.
+ *
+ * @alpha
+ */
+export interface FluidAdapterOptions {
+    /**
+     * Optional prefix to add to policy names. Useful for namespacing Fluid policies.
+     *
+     * @example "Fluid:" would result in "Fluid:my-handler-name"
+     */
+    namePrefix?: string;
+}
+/**
+ * Converts FluidFramework handlers to repopo PolicyDefinitions.
+ *
+ * This adapter bridges the gap between FluidFramework's build-tools policy system
+ * and repopo's policy system, allowing you to reuse existing Fluid policies in repopo.
+ *
+ * @remarks
+ *
+ * Key differences handled by this adapter:
+ *
+ * - **Handler signature**: Fluid uses `(file, root) => string | undefined`,
+ *   repopo uses `(args) => PolicyHandlerResult`
+ *
+ * - **File paths**: Fluid passes absolute paths, repopo passes repo-relative paths.
+ *   The adapter converts between the two.
+ *
+ * - **Return types**: Fluid returns `string | undefined` (error message or success),
+ *   repopo returns `true | PolicyFailure | PolicyFixResult`
+ *
+ * For a single handler, wrap it in an array: `fromFluidHandlers([handler])`.
+ *
+ * @example
+ * ```typescript
+ * import { fromFluidHandlers, makePolicy } from "repopo";
+ * import { copyrightFileHeaderHandlers, fluidCaseHandler } from "@fluidframework/build-tools";
+ *
+ * // Convert multiple handlers with a namespace prefix
+ * const FluidCopyrightPolicies = fromFluidHandlers(copyrightFileHeaderHandlers, {
+ *   namePrefix: "Fluid:",
+ * });
+ *
+ * // For a single handler, wrap it in an array
+ * const [FluidCasePolicy] = fromFluidHandlers([fluidCaseHandler]);
+ *
+ * const config: RepopoConfig = {
+ *   policies: [
+ *     ...FluidCopyrightPolicies.map(p => makePolicy(p)),
+ *     makePolicy(FluidCasePolicy),
+ *   ],
+ * };
+ * ```
+ *
+ * @param fluidHandlers - An array of FluidFramework Handler objects to convert.
+ * @param options - Optional configuration applied to all conversions.
+ * @returns An array of repopo PolicyDefinitions.
+ *
+ * @alpha
+ */
+export declare function fromFluidHandlers(fluidHandlers: FluidHandler[], options?: FluidAdapterOptions): PolicyDefinition[];
+//# sourceMappingURL=fluidFramework.d.ts.map

package/esm/adapters/fluidFramework.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fluidFramework.d.ts","sourceRoot":"","sources":["../../src/adapters/fluidFramework.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACX,gBAAgB,EAIhB,MAAM,cAAc,CAAC;AAEtB;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC5B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;;;;;OAMG;IACH,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAErE;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,CACV,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,KAEV,OAAO,CAAC;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAChD;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3C;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IACnC;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAwFD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,wBAAgB,iBAAiB,CAChC,aAAa,EAAE,YAAY,EAAE,EAC7B,OAAO,CAAC,EAAE,mBAAmB,GAC3B,gBAAgB,EAAE,CAEpB"}

package/esm/adapters/fluidFramework.js

@@ -0,0 +1,119 @@
+import path from "pathe";
+import { makePolicyDefinition } from "../makePolicy.js";
+/**
+ * Converts a FluidFramework handler to a repopo PolicyDefinition.
+ *
+ * This is an internal function used by {@link fromFluidHandlers}.
+ *
+ * @param fluidHandler - A FluidFramework Handler object to convert.
+ * @param options - Optional configuration for the conversion.
+ * @returns A repopo PolicyDefinition that wraps the Fluid handler.
+ *
+ * @internal
+ */
+function fromFluidHandler(fluidHandler, options) {
+    const { namePrefix = "" } = options ?? {};
+    const policyName = `${namePrefix}${fluidHandler.name}`;
+    const handler = async ({ file, root, resolve }) => {
+        // Fluid handlers expect absolute paths
+        const absolutePath = path.join(root, file);
+        const errorMessage = await fluidHandler.handler(absolutePath, root);
+        if (errorMessage === undefined) {
+            return true;
+        }
+        // Check if resolver exists to determine if auto-fixable
+        const autoFixable = fluidHandler.resolver !== undefined;
+        // If resolve is requested and we have a resolver, try to fix
+        if (resolve && fluidHandler.resolver !== undefined) {
+            const resolveResult = await fluidHandler.resolver(absolutePath, root);
+            return {
+                name: policyName,
+                file,
+                errorMessages: [resolveResult.message ?? errorMessage],
+                autoFixable: true,
+                resolved: resolveResult.resolved,
+            };
+        }
+        return {
+            name: policyName,
+            file,
+            errorMessages: [errorMessage],
+            autoFixable,
+        };
+    };
+    // Create standalone resolver if Fluid handler has one
+    let resolver;
+    if (fluidHandler.resolver !== undefined) {
+        resolver = async ({ file, root }) => {
+            const absolutePath = path.join(root, file);
+            // First get the error message for context
+            const errorMessage = await fluidHandler.handler(absolutePath, root);
+            // biome-ignore lint/style/noNonNullAssertion: we checked this is defined above
+            const resolveResult = await fluidHandler.resolver(absolutePath, root);
+            return {
+                name: policyName,
+                file,
+                errorMessages: [
+                    resolveResult.message ?? errorMessage ?? "Unknown error",
+                ],
+                autoFixable: true,
+                resolved: resolveResult.resolved,
+            };
+        };
+    }
+    return makePolicyDefinition(policyName, fluidHandler.match, handler, undefined, // no config
+    undefined, // no description
+    resolver);
+}
+/**
+ * Converts FluidFramework handlers to repopo PolicyDefinitions.
+ *
+ * This adapter bridges the gap between FluidFramework's build-tools policy system
+ * and repopo's policy system, allowing you to reuse existing Fluid policies in repopo.
+ *
+ * @remarks
+ *
+ * Key differences handled by this adapter:
+ *
+ * - **Handler signature**: Fluid uses `(file, root) => string | undefined`,
+ *   repopo uses `(args) => PolicyHandlerResult`
+ *
+ * - **File paths**: Fluid passes absolute paths, repopo passes repo-relative paths.
+ *   The adapter converts between the two.
+ *
+ * - **Return types**: Fluid returns `string | undefined` (error message or success),
+ *   repopo returns `true | PolicyFailure | PolicyFixResult`
+ *
+ * For a single handler, wrap it in an array: `fromFluidHandlers([handler])`.
+ *
+ * @example
+ * ```typescript
+ * import { fromFluidHandlers, makePolicy } from "repopo";
+ * import { copyrightFileHeaderHandlers, fluidCaseHandler } from "@fluidframework/build-tools";
+ *
+ * // Convert multiple handlers with a namespace prefix
+ * const FluidCopyrightPolicies = fromFluidHandlers(copyrightFileHeaderHandlers, {
+ *   namePrefix: "Fluid:",
+ * });
+ *
+ * // For a single handler, wrap it in an array
+ * const [FluidCasePolicy] = fromFluidHandlers([fluidCaseHandler]);
+ *
+ * const config: RepopoConfig = {
+ *   policies: [
+ *     ...FluidCopyrightPolicies.map(p => makePolicy(p)),
+ *     makePolicy(FluidCasePolicy),
+ *   ],
+ * };
+ * ```
+ *
+ * @param fluidHandlers - An array of FluidFramework Handler objects to convert.
+ * @param options - Optional configuration applied to all conversions.
+ * @returns An array of repopo PolicyDefinitions.
+ *
+ * @alpha
+ */
+export function fromFluidHandlers(fluidHandlers, options) {
+    return fluidHandlers.map((h) => fromFluidHandler(h, options));
+}
+//# sourceMappingURL=fluidFramework.js.map

package/esm/adapters/fluidFramework.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fluidFramework.js","sourceRoot":"","sources":["../../src/adapters/fluidFramework.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,OAAO,CAAC;AACzB,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAgExD;;;;;;;;;;GAUG;AACH,SAAS,gBAAgB,CACxB,YAA0B,EAC1B,OAA6B;IAE7B,MAAM,EAAE,UAAU,GAAG,EAAE,EAAE,GAAG,OAAO,IAAI,EAAE,CAAC;IAC1C,MAAM,UAAU,GAAG,GAAG,UAAU,GAAG,YAAY,CAAC,IAAI,EAAE,CAAC;IAEvD,MAAM,OAAO,GAAkB,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE;QAChE,uCAAuC;QACvC,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAE3C,MAAM,YAAY,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;QAEpE,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;YAChC,OAAO,IAAI,CAAC;QACb,CAAC;QAED,wDAAwD;QACxD,MAAM,WAAW,GAAG,YAAY,CAAC,QAAQ,KAAK,SAAS,CAAC;QAExD,6DAA6D;QAC7D,IAAI,OAAO,IAAI,YAAY,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACpD,MAAM,aAAa,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;YAEtE,OAAO;gBACN,IAAI,EAAE,UAAU;gBAChB,IAAI;gBACJ,aAAa,EAAE,CAAC,aAAa,CAAC,OAAO,IAAI,YAAY,CAAC;gBACtD,WAAW,EAAE,IAAI;gBACjB,QAAQ,EAAE,aAAa,CAAC,QAAQ;aACN,CAAC;QAC7B,CAAC;QAED,OAAO;YACN,IAAI,EAAE,UAAU;YAChB,IAAI;YACJ,aAAa,EAAE,CAAC,YAAY,CAAC;YAC7B,WAAW;SACX,CAAC;IACH,CAAC,CAAC;IAEF,sDAAsD;IACtD,IAAI,QAA8C,CAAC;IACnD,IAAI,YAAY,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QACzC,QAAQ,GAAG,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE;YACnC,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAE3C,0CAA0C;YAC1C,MAAM,YAAY,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;YAEpE,+EAA+E;YAC/E,MAAM,aAAa,GAAG,MAAM,YAAY,CAAC,QAAS,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;YAEvE,OAAO;gBACN,IAAI,EAAE,UAAU;gBAChB,IAAI;gBACJ,aAAa,EAAE;oBACd,aAAa,CAAC,OAAO,IAAI,YAAY,IAAI,eAAe;iBACxD;gBACD,WAAW,EAAE,IAAI;gBACjB,QAAQ,EAAE,aAAa,CAAC,QAAQ;aAChC,CAAC;QACH,CAAC,CAAC;IACH,CAAC;IAED,OAAO,oBAAoB,CAC1B,UAAU,EACV,YAAY,CAAC,KAAK,EAClB,OAAO,EACP,SAAS,EAAE,YAAY;IACvB,SAAS,EAAE,iBAAiB;IAC5B,QAAQ,CACR,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,MAAM,UAAU,iBAAiB,CAChC,aAA6B,EAC7B,OAA6B;IAE7B,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;AAC/D,CAAC","sourcesContent":["import path from \"pathe\";\nimport { makePolicyDefinition } from \"../makePolicy.js\";\nimport type {\n\tPolicyDefinition,\n\tPolicyFixResult,\n\tPolicyHandler,\n\tPolicyStandaloneResolver,\n} from \"../policy.js\";\n\n/**\n * A FluidFramework build-tools policy handler interface.\n *\n * This interface matches the `Handler` interface from `@fluidframework/build-tools`.\n *\n * @alpha\n */\nexport interface FluidHandler {\n\t/**\n\t * The name of the handler, used for filtering and display.\n\t */\n\tname: string;\n\n\t/**\n\t * A regex pattern that determines which files this handler applies to.\n\t */\n\tmatch: RegExp;\n\n\t/**\n\t * The handler function that checks a file against the policy.\n\t *\n\t * @param file - Absolute path to the file.\n\t * @param root - Path to the repo root.\n\t * @returns `undefined` if the check passes, otherwise an error message string.\n\t */\n\thandler: (file: string, root: string) => Promise<string | undefined>;\n\n\t/**\n\t * Optional resolver function that attempts to fix policy violations.\n\t *\n\t * @param file - Absolute path to the file.\n\t * @param root - Path to the repo root.\n\t * @returns An object indicating whether the fix was successful.\n\t */\n\tresolver?: (\n\t\tfile: string,\n\t\troot: string,\n\t) =>\n\t\t| Promise<{ resolved: boolean; message?: string }>\n\t\t| { resolved: boolean; message?: string };\n}\n\n/**\n * Options for converting FluidFramework handlers to repopo policies.\n *\n * @alpha\n */\nexport interface FluidAdapterOptions {\n\t/**\n\t * Optional prefix to add to policy names. Useful for namespacing Fluid policies.\n\t *\n\t * @example \"Fluid:\" would result in \"Fluid:my-handler-name\"\n\t */\n\tnamePrefix?: string;\n}\n\n/**\n * Converts a FluidFramework handler to a repopo PolicyDefinition.\n *\n * This is an internal function used by {@link fromFluidHandlers}.\n *\n * @param fluidHandler - A FluidFramework Handler object to convert.\n * @param options - Optional configuration for the conversion.\n * @returns A repopo PolicyDefinition that wraps the Fluid handler.\n *\n * @internal\n */\nfunction fromFluidHandler(\n\tfluidHandler: FluidHandler,\n\toptions?: FluidAdapterOptions,\n): PolicyDefinition {\n\tconst { namePrefix = \"\" } = options ?? {};\n\tconst policyName = `${namePrefix}${fluidHandler.name}`;\n\n\tconst handler: PolicyHandler = async ({ file, root, resolve }) => {\n\t\t// Fluid handlers expect absolute paths\n\t\tconst absolutePath = path.join(root, file);\n\n\t\tconst errorMessage = await fluidHandler.handler(absolutePath, root);\n\n\t\tif (errorMessage === undefined) {\n\t\t\treturn true;\n\t\t}\n\n\t\t// Check if resolver exists to determine if auto-fixable\n\t\tconst autoFixable = fluidHandler.resolver !== undefined;\n\n\t\t// If resolve is requested and we have a resolver, try to fix\n\t\tif (resolve && fluidHandler.resolver !== undefined) {\n\t\t\tconst resolveResult = await fluidHandler.resolver(absolutePath, root);\n\n\t\t\treturn {\n\t\t\t\tname: policyName,\n\t\t\t\tfile,\n\t\t\t\terrorMessages: [resolveResult.message ?? errorMessage],\n\t\t\t\tautoFixable: true,\n\t\t\t\tresolved: resolveResult.resolved,\n\t\t\t} satisfies PolicyFixResult;\n\t\t}\n\n\t\treturn {\n\t\t\tname: policyName,\n\t\t\tfile,\n\t\t\terrorMessages: [errorMessage],\n\t\t\tautoFixable,\n\t\t};\n\t};\n\n\t// Create standalone resolver if Fluid handler has one\n\tlet resolver: PolicyStandaloneResolver | undefined;\n\tif (fluidHandler.resolver !== undefined) {\n\t\tresolver = async ({ file, root }) => {\n\t\t\tconst absolutePath = path.join(root, file);\n\n\t\t\t// First get the error message for context\n\t\t\tconst errorMessage = await fluidHandler.handler(absolutePath, root);\n\n\t\t\t// biome-ignore lint/style/noNonNullAssertion: we checked this is defined above\n\t\t\tconst resolveResult = await fluidHandler.resolver!(absolutePath, root);\n\n\t\t\treturn {\n\t\t\t\tname: policyName,\n\t\t\t\tfile,\n\t\t\t\terrorMessages: [\n\t\t\t\t\tresolveResult.message ?? errorMessage ?? \"Unknown error\",\n\t\t\t\t],\n\t\t\t\tautoFixable: true,\n\t\t\t\tresolved: resolveResult.resolved,\n\t\t\t};\n\t\t};\n\t}\n\n\treturn makePolicyDefinition(\n\t\tpolicyName,\n\t\tfluidHandler.match,\n\t\thandler,\n\t\tundefined, // no config\n\t\tundefined, // no description\n\t\tresolver,\n\t);\n}\n\n/**\n * Converts FluidFramework handlers to repopo PolicyDefinitions.\n *\n * This adapter bridges the gap between FluidFramework's build-tools policy system\n * and repopo's policy system, allowing you to reuse existing Fluid policies in repopo.\n *\n * @remarks\n *\n * Key differences handled by this adapter:\n *\n * - **Handler signature**: Fluid uses `(file, root) => string | undefined`,\n *   repopo uses `(args) => PolicyHandlerResult`\n *\n * - **File paths**: Fluid passes absolute paths, repopo passes repo-relative paths.\n *   The adapter converts between the two.\n *\n * - **Return types**: Fluid returns `string | undefined` (error message or success),\n *   repopo returns `true | PolicyFailure | PolicyFixResult`\n *\n * For a single handler, wrap it in an array: `fromFluidHandlers([handler])`.\n *\n * @example\n * ```typescript\n * import { fromFluidHandlers, makePolicy } from \"repopo\";\n * import { copyrightFileHeaderHandlers, fluidCaseHandler } from \"@fluidframework/build-tools\";\n *\n * // Convert multiple handlers with a namespace prefix\n * const FluidCopyrightPolicies = fromFluidHandlers(copyrightFileHeaderHandlers, {\n *   namePrefix: \"Fluid:\",\n * });\n *\n * // For a single handler, wrap it in an array\n * const [FluidCasePolicy] = fromFluidHandlers([fluidCaseHandler]);\n *\n * const config: RepopoConfig = {\n *   policies: [\n *     ...FluidCopyrightPolicies.map(p => makePolicy(p)),\n *     makePolicy(FluidCasePolicy),\n *   ],\n * };\n * ```\n *\n * @param fluidHandlers - An array of FluidFramework Handler objects to convert.\n * @param options - Optional configuration applied to all conversions.\n * @returns An array of repopo PolicyDefinitions.\n *\n * @alpha\n */\nexport function fromFluidHandlers(\n\tfluidHandlers: FluidHandler[],\n\toptions?: FluidAdapterOptions,\n): PolicyDefinition[] {\n\treturn fluidHandlers.map((h) => fromFluidHandler(h, options));\n}\n"]}

package/esm/baseCommand.d.ts

@@ -10,6 +10,7 @@ export declare abstract class BaseRepopoCommand<T extends typeof BaseRepopoComma
     flags: typeof CommandWithConfig.flags;
 }> extends CommandWithConfig<T, RepopoConfig> implements CommandWithContext<RepopoCommandContext>, RequiresGit {
     protected defaultConfig: RepopoConfig;
+    protected _logger: import("@tylerbu/cli-api").Logger;
     static readonly flags: {
         readonly config: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };