repopo 0.7.1 → 0.9.0

package/CHANGELOG.md

@@ -1,5 +1,222 @@
 # repopo
 
+## 0.9.0
+
+### Minor Changes
+
+- Make `description` required on PolicyDefinition _[`#594`](https://github.com/tylerbutler/tools-monorepo/pull/594) [`c3d1b65`](https://github.com/tylerbutler/tools-monorepo/commit/c3d1b65299f58b9fa605ebd18e7fb4346ae7745f) [@tylerbutler](https://github.com/tylerbutler)_
+
+  BREAKING CHANGE: `PolicyDefinition.description` is now required (was optional). All policies must include a description that explains their purpose.
+
+  All built-in policies now include descriptions.
+
+- Use object parameters for policy factory functions and Policy class _[`#594`](https://github.com/tylerbutler/tools-monorepo/pull/594) [`c3d1b65`](https://github.com/tylerbutler/tools-monorepo/commit/c3d1b65299f58b9fa605ebd18e7fb4346ae7745f) [@tylerbutler](https://github.com/tylerbutler)_
+
+  BREAKING CHANGES:
+  - `makePolicyDefinition()` now takes an object argument: `{ name, description, match, handler, defaultConfig?, resolver? }`
+  - `definePackagePolicy()` now takes an object argument: `{ name, description, handler }`
+  - `defineFileHeaderPolicy()` now takes an object argument: `{ name, description, config }`
+  - `Policy` class constructor now takes a `PolicyDefinition` object instead of positional arguments
+
+  This change makes it easier to add new optional properties in the future without breaking changes.
+
+  New exports:
+  - `makePolicyDefinition` function (previously internal)
+  - `PolicyDefinitionInput` type
+  - `DefinePackagePolicyArgs` interface
+  - `DefineFileHeaderPolicyArgs` interface
+
+### Patch Changes
+
+- Refactor to use Effection 4 for structured concurrency _[`#379`](https://github.com/tylerbutler/tools-monorepo/pull/379) [`1582ad1`](https://github.com/tylerbutler/tools-monorepo/commit/1582ad1abc79b211492dba2e5172e995c9c47fe0) [@tylerbutler](https://github.com/tylerbutler)_
+  - Replace manual async handling with Effection's structured concurrency primitives
+  - Policy handlers now support generator functions for better cancellation and resource management
+  - Improved internal architecture for concurrent policy execution
+  - Added comprehensive test coverage for async/generator patterns
+
+<details><summary>Updated 1 dependency</summary>
+
+<small>
+
+[`c577266`](https://github.com/tylerbutler/tools-monorepo/commit/c577266129da545000aea343256b06129a243987)
+
+</small>
+
+- `@tylerbu/cli-api@0.10.1`
+
+</details>
+
+## 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
@@ -23,7 +240,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
 
@@ -39,7 +255,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)
 
@@ -48,7 +263,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)
@@ -112,18 +326,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.1
 
 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:
 
@@ -112,11 +142,12 @@ OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 
 -----------
 
-The following npm package may be included in this product:
+The following npm packages may be included in this product:
 
+ - effection@4.0.0
  - simple-git@3.30.0
 
-This package contains the following license:
+These packages each contain the following license:
 
 MIT
 
@@ -125,7 +156,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 +214,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 +274,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 +409,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"}