@bridge-ds/core 0.10.0 → 0.12.0

package/README.md

@@ -283,6 +283,22 @@ reviewSuggestionOnGitHub(gh, n, { event, role?, message?, payloadSha? }, gov); l
 declineSuggestionOnGitHub(gh, n, reason, by?); syncSuggestionStateLabel(gh, n, labels, status);
 ```
 
+## storybook (storybook.ts)
+
+Reads a deployed or built Storybook without the repo: `index.json` (v4 for Storybook 7, v5 for 8 and later), else
+`stories.json` (v3). Entries are grouped by title into components (name = last title segment); test entries stay out
+of `stories`. A 404, an HTML answer from a host that falls back to `index.html`, or a body with no entries moves on to
+the next file. Errors carry a code: `invalid-url`, `not-found`, `not-json`, `private` (sign-in wall, Chromatic login
+answer, 401/403), `empty`, `http`, `network`. Pure, with an injected `fetch`; `@bridge-ds/visual` uses the parser for
+`storybook-static/index.json` and the iframe URL builder for its captures.
+
+```ts
+fetchStorybookIndex(base, { fetch?, signal? }): Promise<{ version; source: 'index.json' | 'stories.json'; entries; components }>;
+parseStorybookIndex(json, source?); groupStorybookComponents(entries): { title; name; group; stories; docs; tags }[];
+normalizeStorybookUrl(pasted): string;   // https only (http on localhost), drops ?path=, /index.html, /iframe.html
+storybookIframeUrl(base, id, { viewMode?, globals?, args? }); storybookManagerUrl(base, id, viewMode?); storybookIndexUrls(base);
+```
+
 ## history (history.ts, history-github.ts, history-demo.ts)
 
 What changed in the tokens, when, who changed it and why, and how to undo it safely.

package/dist/figma-push-github.d.ts

@@ -1,6 +1,6 @@
 import type { ChangesMode } from './config';
 import { type GitHubClient } from './github-client';
-import { type SuggestionPayloadV1 } from './suggestions';
+import { type SuggestionFigmaNode, type SuggestionPayloadV1 } from './suggestions';
 import type { TokenEdit } from './token-edits';
 import { type ComponentPushDiff, type ComponentPushPlan, type FigmaOrigin, type FigmaPushStatus, type PushTokenContext } from './figma-push';
 /**
@@ -19,6 +19,7 @@ export type FigmaTokenWriter = (input: {
         fileKey?: string | undefined;
         nodeId?: string | undefined;
         url?: string | undefined;
+        nodes?: SuggestionFigmaNode[] | undefined;
     };
 }) => Promise<{
     number: number;
@@ -83,6 +84,10 @@ export declare function componentSpecSuggestionPayload(d: ComponentPushDiff, pla
     createdAt?: string | undefined;
     componentsDir?: string | undefined;
 }): SuggestionPayloadV1;
+/** The Figma nodes of a push for a suggestion's links: the component as it is now (after), and before when known. */
+export declare function figmaNodes(d: Pick<ComponentPushDiff, 'figma'>): {
+    nodes?: SuggestionFigmaNode[];
+};
 /**
  * Opens the library branch of a component change from Figma, linked to its origin (the Figma component): an exact token
  * swap opens a token change (the shared proposal write: contrast gate, tier, changeset); anything that needs code opens

package/dist/figma-push.d.ts

@@ -51,6 +51,12 @@ export interface ComponentPushDiff {
         nodeId?: string | undefined;
         nodeName?: string | undefined;
         url?: string | undefined;
+        /** A node that shows the design before the change, when the file keeps one (optional). */
+        before?: {
+            nodeId: string;
+            nodeName?: string | undefined;
+            url?: string | undefined;
+        } | undefined;
     } | undefined;
     /** The component as Figma has it now: variant axes, properties, bound variables (token paths) per variant. */
     variantAxes: Record<string, string[]>;

package/dist/index.d.ts

@@ -63,3 +63,4 @@ export * from './suggestions';
 export * from './suggestion-review';
 export * from './suggestions-github';
 export * from './suggestion-apply';
+export * from './storybook';