@bridge-ds/core 0.19.0 → 0.20.0

package/LICENSE

@@ -0,0 +1,17 @@
+MIT License
+
+Copyright (c) 2026 Florian Gouloubi
+
+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.

package/bridge.config.schema.json

@@ -458,6 +458,11 @@
           "description": "For a design system run by one person. When true and the owners resolve to exactly one person who holds both roles, that person's approval counts as the design and the tech approval, so Tier 2 and Tier 3 changes can be approved. The author of a change still never approves it. Default false: one person never covers both approvals alone.",
           "default": false
         },
+        "leadsPublishTier1": {
+          "type": "boolean",
+          "description": "Leads can publish small changes without review. When true (or absent), team admins and the reviewers of the matching domain (design for docs and guidance, tech for code-only Tier 1) publish a Tier 1 change directly: Bridge opens the pull request, waits for the checks and merges it, recording who published it. A failing check sends it to review instead. Tier 2 and 3 are unchanged. Changing it is a Tier 3 change (bridge.config.json is a guardrail file).",
+          "default": true
+        },
         "rights": {
           "type": "object",
           "additionalProperties": false,

package/dist/audit/index.js

@@ -1,6 +1,6 @@
-import { i as isAuditable, a as auditFile } from "../report-DFPKygfk.js";
-import { A, b, c, C, D, d, F, I, L, e, M, N, f, g, h, j, k, l, m, n, o, p, q, r, s, t, u, v, w, x, y, z, B, E, G, H, J, K, O, P, Q, R, S, T, U, V, W, X, Y, Z } from "../report-DFPKygfk.js";
-import { p as pieceId, a as proposedTokenPath, t as tokenLabel } from "../prod-branch-Bdx_2bRQ.js";
+import { i as isAuditable, a as auditFile } from "../report-CE-jHAuw.js";
+import { A, b, c, C, D, d, F, I, L, e, M, N, f, g, h, j, k, l, m, n, o, p, q, r, s, t, u, v, w, x, y, z, B, E, G, H, J, K, O, P, Q, R, S, T, U, V, W, X, Y, Z } from "../report-CE-jHAuw.js";
+import { p as pieceId, a as proposedTokenPath, t as tokenLabel } from "../prod-branch-CJZwMfVD.js";
 const lines = (text) => text.split(/\r?\n/);
 function lineBag(text) {
   const bag = /* @__PURE__ */ new Map();

package/dist/config.d.ts

@@ -141,6 +141,11 @@ export interface GovernanceConfig {
      * person's approval counts for design and tech. Default false: one person never covers both approvals alone.
      */
     soloOwnerCanApproveBoth?: boolean | undefined;
+    /**
+     * Team admins and the reviewers of the matching domain publish a Tier 1 change without review (docs/GOVERNANCE.md,
+     * "Tier 1 publish by leads"). Absent counts as on (leadsPublishTier1On); false turns it off.
+     */
+    leadsPublishTier1?: boolean | undefined;
 }
 /** `bridge audit` settings: how product code that consumes the design system is measured. */
 export interface AuditConfig {

package/dist/fidelity.d.ts

@@ -132,7 +132,18 @@ export declare function buildFidelityReport(input: {
     file?: string;
     now?: Date;
 }): FidelityReport;
-/** One variant's verdict: "Matches the code" or "Differs from the code: 12% of pixels, size 120x40 vs 118x40". */
+/**
+ * A size difference past the tolerance, in designer words: "height 89 in Figma vs 48 in code". It says more than the
+ * share of pixels when the two images do not have the same size (a 1% pixel score can hide a set twice as tall).
+ */
+export declare function sizeGap(s: {
+    figma: Size;
+    code: Size;
+}, tolerance?: number): string | undefined;
+/**
+ * One variant's verdict: "Matches the code", "Differs from the code: 12% of pixels", or the size first when the size
+ * differs: "Differs from the code: height 89 in Figma vs 48 in code, 1.4% of pixels".
+ */
 export declare function fidelityVerdict(v: Pick<FidelityVariantResult, 'status' | 'percent' | 'size' | 'reason'>): string;
 /** One component's line, from its worst variant. */
 export declare function fidelityComponentLine(c: FidelityComponentResult): string;

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/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/index.d.ts

@@ -53,7 +53,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';