@bridge-ds/core 0.18.0 → 0.20.0

package/dist/motion-docs.d.ts

@@ -0,0 +1,51 @@
+import { type ComponentSpec, type SpecCoverage, type SpecTransition } from './component-spec';
+/** A motion token as the page shows it: the token name (mono) and its value in words ("75 ms"). */
+export interface MotionValue {
+    token?: string | undefined;
+    value: string;
+}
+export interface MotionRow {
+    /** The part that moves, when the component has several ("Popup", "Checkbox item"). */
+    part?: string | undefined;
+    /** What makes it move, designer words ("Hover", "Open", "Check and uncheck"). */
+    when: string;
+    /** What changes ("Background and text color"). */
+    what: string;
+    duration: MotionValue;
+    easing: MotionValue | null;
+}
+export interface MotionDocs {
+    /** One sentence: what animates, or that nothing does. */
+    summary: string;
+    rows: MotionRow[];
+    /** What reduced motion does, one sentence; null when nothing animates. */
+    reduced: string | null;
+    /** Whether to show a Part column (several parts move). */
+    showPart: boolean;
+    /** Motion tokens the component's CSS uses for motion the rows do not list (a tab indicator sliding). */
+    unlisted: string[];
+}
+/** CSS properties in designer words, joined: ["background-color", "color"] -> "Background and text color". */
+export declare function propertyWords(props: string[]): string;
+/** A duration in ms, with its token. */
+export declare const durationValue: (t: Pick<SpecTransition, "duration" | "durationToken">) => MotionValue;
+/** An easing in words, with its token: motion.easing.enter -> "starts fast, lands softly". */
+export declare function easingValue(t: Pick<SpecTransition, 'easing' | 'easingToken'>): MotionValue;
+/** The part a set draws, in words: "Combobox/Popup" -> "Popup", "MenuCheckboxItem" -> "Checkbox item". */
+export declare function partLabel(spec: Pick<ComponentSpec, 'name' | 'component' | 'view'>, component: string): string;
+/** A moment a set moves: what makes it move ("Hover", "Open"), the transition, the properties it animates. */
+export interface MotionMoment {
+    when: string;
+    t: SpecTransition;
+    props: string[];
+}
+/**
+ * The moments a set moves, from its interactions and its opening and closing: one per trigger and speed (Hover,
+ * Press, Check, Uncheck, Open, Close). Instant changes are left out.
+ */
+export declare function motionMoments(spec: Pick<ComponentSpec, 'name' | 'variants' | 'interactions' | 'motion'>): MotionMoment[];
+/**
+ * The section for one component: its sets (specs whose `component`, or name, is the component), and its Figma coverage
+ * entry for the components the generator does not read (drafted, layout helpers).
+ */
+export declare function motionDocs(component: string, specs: ComponentSpec[], coverage?: Pick<SpecCoverage, 'status' | 'reason'>, codeTokens?: string[]): MotionDocs;

package/dist/node/audit.d.ts

@@ -1,6 +1,6 @@
 import { type BridgeConfig } from '../config';
 import { LayeredTokenSet } from '../layered';
-import { type CssFixEdit } from '../audit/report';
+import { type CssFixEdit, type CssFixKept } from '../audit/report';
 import { DesignSystemIndex } from '../audit/ds-index';
 import type { AllowlistEntry, AuditReport } from '../audit/types';
 export interface LoadedDesignSystem {
@@ -40,8 +40,16 @@ export interface RunAuditOptions {
 export declare function loadAllowlist(path: string): AllowlistEntry[];
 /** Audit a product folder against a design system. */
 export declare function runAudit(target: string, opts?: RunAuditOptions): AuditReport;
-/** Plan (and optionally write) the safe CSS autofix for every CSS/SCSS/Less file under `target`. */
-export declare function fixCss(target: string, ds: DesignSystemIndex, write: boolean): {
+/**
+ * Plan (and optionally write) the safe CSS autofix for every CSS/SCSS/Less file under `target`, with the audit's own
+ * rules: the files bridge.config.json excludes from the audit (audit.exclude) are left alone, and so are the values an
+ * ignore comment or the allowlist keeps (returned in `kept`).
+ */
+export declare function fixCss(target: string, ds: DesignSystemIndex, write: boolean, opts?: {
+    exclude?: string[] | undefined;
+    allowlist?: AllowlistEntry[] | undefined;
+}): {
     file: string;
     edits: CssFixEdit[];
+    kept: CssFixKept[];
 }[];

package/dist/node/index.d.ts

@@ -6,3 +6,4 @@ export * from './spec-css';
 export * from './spec-motion';
 export * from './suggestion-apply-node';
 export * from './fs-source';
+export * from './measure';