/**
 * The one spelling of "repo-relative path" in the pipeline.
 *
 * Three consumers need a source file expressed the same way — the `sourcePath`
 * on every extracted type (LocalTypesExtractor), the `sourceHref` GitHub link
 * and the type-ownership directory index (APIDataGenerator) — and ownership
 * only resolves when the last two agree with the first *character for
 * character*. They did not: two of them matched `/(packages\/.+)$/`, which has
 * no leading separator and takes the leftmost match, so a checkout in a
 * directory whose name merely *ends* in `packages` matched inside that name:
 *
 * ```
 * /home/me/ui/packages/blocks/…      → packages/blocks/…            (agreed)
 * /home/me/dev-packages/ui/packages/blocks/…
 *                                    → packages/ui/packages/blocks/… (did not)
 * ```
 *
 * The consequence was silent: `componentsByDir` keyed on paths no `sourcePath`
 * could ever match, so `owner` was simply absent everywhere and the feature
 * degraded to its pre-existing behaviour without a word. Hence one function
 * rather than three hand-aligned copies.
 */
/**
 * `packages/<pkg>/…` for a path inside the monorepo's package tree, else
 * `null`.
 *
 * Three properties, each learned by breaking it:
 *
 * - `packages` must be a whole path segment. Matching the bare substring is
 *   what made a `…-packages/` checkout directory look like the package root.
 * - The input may already *be* repo-relative. `TypeDefinition.sourcePath` is
 *   stored in this very form, and ownership resolution feeds it back in to
 *   get its directory. An intermediate `path.resolve()` here turned
 *   `packages/blocks/…` into `<cwd>/packages/blocks/…` and then re-anchored on
 *   the cwd's own `packages/` segment — measured: 573 of 967 entries lost
 *   their owner, silently.
 * - **The function must be idempotent**, which is why the already-relative
 *   branch is tested *first* rather than after the segment scan. A checkout
 *   under a directory simply named `packages` produces an output that itself
 *   still contains a later `/packages/`:
 *
 *   ```
 *   /home/me/packages/ui/packages/blocks/…/Dialog/index.ts
 *     once  → packages/ui/packages/blocks/…/Dialog/index.ts
 *     twice → packages/blocks/…/Dialog/index.ts          (≠ once)
 *   ```
 *
 *   Ownership applies this once to a component's absolute path and twice to a
 *   type's stored `sourcePath`, so a non-idempotent rule makes the two
 *   disagree and drops `owner` from every entry without a word. Scanning for
 *   the segment first was a regression against the ordering here: that
 *   checkout shape resolved correctly before the helper existed.
 */
export declare function repoRelativePackagePath(filePath: string): string | null;
/** Directory part of {@link repoRelativePackagePath}, or `null`. */
export declare function repoRelativePackageDir(filePath: string): string | null;
//# sourceMappingURL=repo-path.d.ts.map