@bridge-ds/core 0.9.0 → 0.10.0

package/dist/prod-branch-github.d.ts

@@ -1,3 +1,4 @@
+import type { ChangesMode } from './config';
 import { type ExplorationSettings } from './explorations-github';
 import { type GitHubClient, type PullRequestSummary } from './github-client';
 import { type ProductConfig } from './products';
@@ -63,15 +64,15 @@ export interface OpenLibraryBranchInput {
     exploration: Pick<ExplorationSettings, 'packages' | 'apps'>;
     /**
      * Opens the token change of a token piece (planTokenProposal + writeTokenProposalOnGitHub where the caller has the
-     * token files and contrast pairs). Without it a token piece is refused.
+     * token files and contrast pairs). Without it a token piece is refused. In suggest mode (`ctx.mode`), it files a
+     * suggestion instead (suggestTokenProposalOnGitHub with `neededBy: plan.neededBy`) and returns its result: a result
+     * with `status: 'suggested'` is linked as a suggestion, anything else as a token change pull request.
      */
     writeTokens?: ((plan: Extract<LibraryBranchPlan, {
         kind: 'token-change';
-    }>) => Promise<{
-        number: number;
-        url: string;
-        branch: string;
-    }>) | undefined;
+    }>, ctx: {
+        mode: ChangesMode;
+    }) => Promise<LibraryTokenWrite>) | undefined;
     /** Who opens it, and the AI agent behind it ("claude"). */
     openedBy?: string | undefined;
     agent?: string | undefined;
@@ -79,9 +80,27 @@ export interface OpenLibraryBranchInput {
     /** Merge the new library branch into the product branch when it already changes something (default true). */
     usePreview?: boolean | undefined;
     dryRun?: boolean | undefined;
+    /**
+     * "direct" (default here, so existing callers keep their behaviour): a token piece opens a pull request, a variant
+     * an exploration branch. "suggest": a token piece is filed as a suggestion and a variant as a component request, so
+     * the token only needs Issues write. Callers pass changesMode(config), or an explicit choice.
+     */
+    mode?: ChangesMode | undefined;
 }
+/** What writeTokens returns: the pull request it opened, or the suggestion it filed. */
+export type LibraryTokenWrite = {
+    number: number;
+    url: string;
+    branch: string;
+    status?: undefined;
+} | {
+    status: 'suggested';
+    number: number;
+    url: string;
+};
 export interface OpenedLibraryBranch {
-    status: 'opened' | 'already-linked' | 'dry-run';
+    /** "suggested": the library side is a suggestion (`link.kind` 'suggestion', `link.number` its issue). */
+    status: 'opened' | 'suggested' | 'already-linked' | 'dry-run';
     plan: LibraryBranchPlan;
     link: LibraryLink | null;
     preview: PreviewMerge | null;
@@ -94,6 +113,8 @@ export declare function productBranchRef(pull: Pick<Pull, 'number' | 'title' | '
  * product branch and carries the `needed-by-product` label; the product branch records the link. A token piece opens a
  * token change (through `writeTokens`), a variant a library exploration, a new component a request. When the new
  * library branch already changes something (a token change), the product branch takes its preview.
+ * In suggest mode nothing is a branch: a token piece is a suggestion (through `writeTokens`), a variant and a new
+ * component are requests; recording the link on the product branch is best effort (a warning when refused).
  */
 export declare function openLibraryBranchOnGitHub(gh: GitHubClient, input: OpenLibraryBranchInput): Promise<OpenedLibraryBranch>;
 export interface LinkedLibraryBranch {

package/dist/prod-branch.d.ts

@@ -1,5 +1,7 @@
 import type { Exploration } from './explorations';
+import type { ChangesMode } from './config';
 import type { ComponentChangeRequest } from './requests';
+import type { SuggestionStatus } from './suggestions';
 import type { TokenEdit } from './token-edits';
 /** What the library lacks: a token value, a variant of an existing component, or a component. */
 export type PieceKind = 'token' | 'variant' | 'component';
@@ -52,13 +54,13 @@ export interface MissingPiece {
         files: string[];
     } | undefined;
 }
-/** Where the library side of a piece lives. */
-export type LibraryLinkKind = 'token-change' | 'exploration' | 'request';
+/** Where the library side of a piece lives. A suggestion is an issue holding the exact token change (suggestions.ts). */
+export type LibraryLinkKind = 'token-change' | 'exploration' | 'request' | 'suggestion';
 export interface LibraryLink {
     /** The piece id. */
     piece: string;
     kind: LibraryLinkKind;
-    /** Pull request number (token change, exploration) or issue number (request). */
+    /** Pull request number (token change, exploration) or issue number (request, suggestion). */
     number: number;
     url: string;
     title: string;
@@ -150,15 +152,18 @@ export type LibraryBranchPlan = {
 };
 /**
  * What a piece opens in the library, honestly labelled by what Bridge can write:
- * - a token piece: a token change (the new token, a draft for review, the usual gate);
- * - a variant: a library exploration (a branch and a draft for the component work, with a brief for Claude);
+ * - a token piece: a token change (the new token, a draft for review, the usual gate); in suggest mode the same
+ *   change is filed as a suggestion;
+ * - a variant: a library exploration (a branch and a draft for the component work, with a brief for Claude); in
+ *   suggest mode a component request, since an exploration is a branch;
  * - a new component: a component request (an issue): it needs design work before code.
  */
 export declare function libraryBranchPlan(piece: MissingPiece, branch: ProductBranchRef, opts?: {
     source?: ComponentChangeRequest['source'];
     requestedBy?: string | undefined;
+    mode?: ChangesMode | undefined;
 }): LibraryBranchPlan;
-export type LinkStatusKey = 'draft' | 'in-review' | 'changes' | 'approved' | 'shipped' | 'closed' | 'exploring' | 'requested' | 'in-progress' | 'done' | 'declined';
+export type LinkStatusKey = 'draft' | 'in-review' | 'changes' | 'approved' | 'shipped' | 'closed' | 'exploring' | 'requested' | 'in-progress' | 'done' | 'declined' | 'outdated';
 export interface LinkStatus {
     key: LinkStatusKey;
     /** "In review", "Shipped". */
@@ -172,7 +177,8 @@ export interface LinkStatus {
 export declare const LINK_STATUS_TONE: Record<LinkStatusKey, 'neutral' | 'info' | 'warning' | 'success' | 'danger'>;
 /**
  * Where a library branch stands, from what GitHub says: a pull request (state, draft, labels, requested reviewers,
- * latest review per person) or a request issue (state, reason, assignees, whether a pull request implements it).
+ * latest review per person), a request issue (state, reason, assignees, whether a pull request implements it) or a
+ * suggestion (its status, suggestionStatus in suggestions.ts, and who it is assigned to).
  */
 export declare function linkStatus(x: {
     kind: 'token-change' | 'exploration';
@@ -190,6 +196,10 @@ export declare function linkStatus(x: {
     stateReason?: string | null | undefined;
     assignees?: readonly string[] | undefined;
     implemented?: boolean | undefined;
+} | {
+    kind: 'suggestion';
+    status: SuggestionStatus;
+    assignees?: readonly string[] | undefined;
 }): LinkStatus;
 export type LibraryPreviewKey = 'nothing-yet' | 'not-used' | 'preview' | 'outdated' | 'published' | 'switched' | 'declined';
 export interface LibraryPreviewState {

package/dist/{report-DY_peRy4.js → report-DOnKUw8G.js}

@@ -1,4 +1,4 @@
-import { bc as hexToRgba, aN as comboKey } from "./pr-composer-D2SZm7cg.js";
+import { bn as hexToRgba, aW as comboKey } from "./prod-branch-BdMPKffE.js";
 import ts from "typescript";
 const AUDIT_SCHEMA_VERSION = 1;
 const FINDING_CATEGORIES = ["color", "spacing", "size", "radius", "border-width", "shadow", "duration", "easing", "z-index", "font-family", "font-size", "font-weight", "line-height"];
@@ -1907,4 +1907,4 @@ export {
   isRouterLink as y,
   isSafeFix as z
 };
-//# sourceMappingURL=report-DY_peRy4.js.map
+//# sourceMappingURL=report-DOnKUw8G.js.map