@bridge-ds/core 0.19.0 → 0.21.0

package/dist/figma-fix-run.d.ts

@@ -0,0 +1,103 @@
+import { type BridgeConfig } from './config';
+import { type FixAttempt, type FixVerdict, type GapCaseForInput, type TriedVariant } from './figma-fix-loop';
+import type { FigmaFix } from './figma-fixes';
+import type { GapCase } from './gap-case';
+/** Where `bridge specs --measure` writes, from the repo root. */
+export declare const DEFAULT_MEASURED_SPECS_FILE = "measured-specs.json";
+/** The label every figma-fixes.json change carries, next to drafted-by-claude. */
+export declare const FIGMA_FIXES_LABEL = "figma-fixes";
+/** Asks Claude one prompt, returns the reply text. Runners pass the team's key; tests pass a fake. */
+export type FixAsk = (prompt: string) => Promise<string>;
+/** Where a loop stands between rounds: plain JSON, so a server can keep it between requests. */
+export interface FixLoopState {
+    component: string;
+    /** Rounds done. */
+    round: number;
+    attempts: FixAttempt[];
+    /** The closest fixes so far (verdict closer), with their score and the referee's summary. */
+    best?: {
+        fixes: unknown[];
+        score: number;
+        summary: string;
+    } | undefined;
+    /** No round left, or every difference resolved. */
+    done: boolean;
+}
+export interface FixLoopRound {
+    round: number;
+    fixes: unknown[];
+    /** invalid: the fixes broke the schema; undefined: no fixes could be read from the reply. */
+    verdict?: FixVerdict | 'invalid' | undefined;
+    summary: string;
+}
+export declare const startFixLoop: (component: string) => FixLoopState;
+/**
+ * One round: Claude proposes fixes from the gap case and what the earlier rounds gave, the values referee tries them,
+ * and the state keeps the closest. `ask` may throw (the network, the key): the state is then unchanged.
+ */
+export declare function fixLoopRound(input: GapCaseForInput, state: FixLoopState, ask: FixAsk, gap?: GapCase): Promise<{
+    state: FixLoopState;
+    round: FixLoopRound;
+}>;
+/** What the loop proposes once done: the closest fixes, or a status fix (Differs, with the reason) when none came closer. */
+export declare function fixLoopOutcome(gap: GapCase, state: FixLoopState, existingIds?: string[]): {
+    kind: 'fixes' | 'status';
+    fixes: unknown[];
+    summary: string;
+};
+/** The branch a component's fixes go on (a number is added when it is taken): bridge/figma-fixes-text-input. */
+export declare const figmaFixesBranchStem: (config: BridgeConfig, component: string) => string;
+export interface FigmaFixesProposalInput extends GapCaseForInput {
+    /** The fixes to propose (fix objects; the repo's fixes with the same ids are replaced). */
+    proposed: unknown[];
+    /** One or two sentences a reviewer reads first. */
+    summary: string;
+    config: BridgeConfig;
+    /** figma-fixes.json path in the repo. */
+    fixesPath: string;
+    /** Who drafted it, for the body and the commit: "Bridge MCP (source: mcp)". */
+    tool: string;
+    /** The `source:` label: mcp, cli, studio. */
+    source: string;
+}
+export interface FigmaFixesReport {
+    component: string;
+    verdict: FixVerdict;
+    summary: string;
+    variants: TriedVariant[];
+    fixes: string[];
+    tier: number;
+    prTitle: string;
+}
+export type FigmaFixesProposal = {
+    status: 'blocked';
+    verdict: FixVerdict;
+    why: string;
+    detail: string;
+    component: string;
+} | {
+    status: 'ready';
+    report: FigmaFixesReport;
+    /** The accepted fixes as validated. */
+    fixes: FigmaFix[];
+    labels: string[];
+    prBody: string;
+    fileContents: {
+        path: string;
+        content: string;
+    }[];
+    title: string;
+    message: string;
+    /** Tier 2 and above open as a draft. */
+    draft: boolean;
+    /** The default branch it targets. */
+    base: string;
+    branchStem: string;
+};
+/**
+ * The change for review of proposed fixes. The values referee runs again first: a fix that moves the component further
+ * from the code is refused, and part or story fixes that move nothing are refused (propose a status fix), unless they
+ * size, place or lay out a part: the values referee can't judge layout, Check fidelity decides. Throws a sentence when
+ * the fixes are invalid or the summary is not one.
+ */
+export declare function figmaFixesProposal(input: FigmaFixesProposalInput): FigmaFixesProposal;

package/dist/figma-fixes.d.ts

@@ -134,8 +134,12 @@ export interface AppliedFix {
     id: string;
     kind: FigmaFix['kind'];
     component: string;
-    /** applied: it changed what the pull draws. not-found: nothing matched (the code or the measure moved: re-check it). already: the input had it. */
-    result: 'applied' | 'not-found' | 'already';
+    /**
+     * applied: it changed what the pull draws. not-found: nothing matched (the code or the measure moved: re-check it).
+     * skipped: it matched, but the measure has no size of the part's own to pin there (the detail says why). already:
+     * the input had it.
+     */
+    result: 'applied' | 'not-found' | 'skipped' | 'already';
     /** Story entries it changed. */
     stories: number;
     /** Plain words: what it did, or what it did not find. */
@@ -152,6 +156,14 @@ export type FixedMeasuredSpecsFile = Omit<MeasuredSpecsFile, 'stories' | 'compon
 };
 /** A story is one of `where`'s variants: every arg it names, at that value, and the state. */
 export declare function storyMatchesWhere(s: MeasuredSpecsStory, where: FixWhere | undefined): boolean;
+/** Why a `fixed` size was not laid on one part of one story: the measure has no size of the part's own there. */
+export interface SkippedSize {
+    part: string;
+    side: 'width' | 'height';
+    why: 'words' | 'fills' | 'unmeasured';
+    /** The measured px it did not pin (words, fills). */
+    measured?: number | undefined;
+}
 /**
  * The measured specs the pull reads, with the fixes laid on, and one provenance record per fix. Pure: the input is not
  * changed. Fixes run in file order; a fix whose component, part or story is not in this measure is reported

package/dist/gap-case.d.ts

@@ -1,5 +1,5 @@
 import { type ComponentSpec, type SpecField, type SpecPart, type SpecValue, type SpecVariant } from './component-spec';
-import type { FidelityComponentResult, Size } from './fidelity';
+import { type FidelityComponentResult, type Size } from './fidelity';
 import { type MeasuredBox, type MeasuredSpec, type MeasuredSpecsFile, type MeasuredSpecsStory, type MeasuredState } from './measured-spec';
 export declare const GAP_CASE_VERSION = 1;
 /** How a story reaches a variant: at rest, a forced pseudo state, or disabled (an arg). */
@@ -114,7 +114,6 @@ export declare function storyState(s: Pick<MeasuredSpecsStory, 'state' | 'props'
 export declare function storyForVariant(spec: Pick<ComponentSpec, 'axes'>, props: Record<string, string>, stories: MeasuredSpecsStory[], shot?: {
     file: string;
 }): MeasuredSpecsStory | undefined;
-/** A part in words: the measure's ids are class names ("cds--toggle__switch" -> "toggle switch"). */
 export declare function partWords(part: Pick<SpecPart, 'id' | 'name'> | undefined, id?: string): string;
 /** Token path -> value, from the measure: components[].resolved, then the token harvest (by CSS name). */
 export declare function measuredResolver(file: Pick<MeasuredSpecsFile, 'components' | 'tokens'>): (path: string) => string | number | undefined;

package/dist/github-client.d.ts

@@ -638,6 +638,23 @@ export declare class GitHubClient {
         autoMerge: boolean;
     }>;
     listPullRequestFiles(n: number): Promise<PullRequestFile[]>;
+    /** The commits of a pull request, oldest first, as GitHub lists them (one read, up to 100). */
+    listPullRequestCommits(n: number): Promise<{
+        sha: string;
+        commit: {
+            message: string;
+            author?: {
+                name?: string | null;
+                date?: string | null;
+            } | null;
+            committer?: {
+                date?: string | null;
+            } | null;
+        };
+        author?: {
+            login?: string | null;
+        } | null;
+    }[]>;
     updatePullRequest(n: number, patch: {
         title?: string;
         body?: string;

package/dist/index.d.ts

@@ -41,6 +41,8 @@ export * from './change-drafts';
 export * from './draft-exchange';
 export * from './explorations';
 export * from './explorations-github';
+export * from './exploration-done-github';
+export * from './exploration-resume';
 export * from './requests-github';
 export * from './component-spec';
 export * from './measured-spec';
@@ -53,7 +55,11 @@ export * from './figma-fixes';
 export * from './measured-only';
 export * from './css-color';
 export * from './figma-fix-loop';
+export * from './figma-fix-run';
+export * from './measure-location';
+export * from './measure-workflow';
 export * from './review-gate';
+export * from './tier1-publish';
 export * from './library-update';
 export * from './branch-actions';
 export * from './jira';