@bridge-ds/toolbar 0.1.0 → 0.2.0

package/dist/{index-yvFRSnsp.js → index-3f0I3tAL.js}

@@ -1,7 +1,7 @@
 import { jsx } from "react/jsx-runtime";
 import { lazy, useState, Suspense, useEffect, useMemo } from "react";
 import { r as readChanges } from "./session-CzlIsFDY.js";
-const Toolbar = lazy(() => import("./Toolbar-B-p9ZCvk.js"));
+const Toolbar = lazy(() => import("./Toolbar-CzR1TM9x.js"));
 function asked() {
   let store = null;
   try {
@@ -44,6 +44,48 @@ function useDocumentScope() {
     [here]
   );
 }
+const DEFAULT_PROXY = "https://bridge.floriangouloubi.com";
+const API = "https://api.github.com";
+const RAW = "https://raw.githubusercontent.com";
+class ReadError extends Error {
+  constructor(message, status) {
+    super(message);
+    this.status = status;
+  }
+  status;
+}
+const LIMIT = "GitHub limits reads without an account to 60 an hour. Try again later.";
+const errorOf = (status) => new ReadError(status === 403 || status === 429 ? LIMIT : `GitHub answered ${status}.`, status);
+const down = /* @__PURE__ */ new Set();
+const proxyRefused = (r) => r.status === 400 || r.status === 401 || r.status === 403 || r.status === 409 || r.status === 429 || r.status >= 500;
+const segments = (path) => path.split("/").map(encodeURIComponent).join("/");
+function githubReads({ team, proxy, fetch: f = (...a) => fetch(...a) }) {
+  const base = proxy ? proxy.replace(/\/+$/, "") : null;
+  async function read2(gh, accept, direct) {
+    if (base && !down.has(base)) {
+      try {
+        const r = await f(`${base}/api/contribute?repo=${encodeURIComponent(team)}&gh=${encodeURIComponent(gh)}`, { headers: { Accept: accept }, credentials: "omit" });
+        if (!proxyRefused(r)) return r;
+      } catch {
+      }
+      down.add(base);
+    }
+    return f(direct, direct.startsWith(API) ? { headers: { Accept: accept } } : {});
+  }
+  return {
+    async api(path) {
+      const r = await read2(path, "application/vnd.github+json", `${API}${path}`);
+      if (!r.ok) throw errorOf(r.status);
+      return await r.json();
+    },
+    async file(owner, repo, ref, path) {
+      const gh = `/repos/${owner}/${repo}/contents/${segments(path)}${ref ? `?ref=${encodeURIComponent(ref)}` : ""}`;
+      const r = await read2(gh, "application/vnd.github.raw", `${RAW}/${owner}/${repo}/${ref ?? "HEAD"}/${segments(path)}`);
+      if (!r.ok) throw errorOf(r.status);
+      return r.text();
+    }
+  };
+}
 const REPO = /^[\w.-]+\/[\w.-]+$/;
 function buildFromConfig(raw, ds, product, overrides = {}) {
   if (!raw || typeof raw !== "object" || !REPO.test(ds)) return null;
@@ -60,6 +102,7 @@ function buildFromConfig(raw, ds, product, overrides = {}) {
     production: pick(overrides.production, entry.production ?? config.previews?.production?.[product]),
     preview: pick(overrides.preview, entry.preview ?? config.previews?.apps?.[product]),
     deployEnv: overrides.deployEnv ?? null,
+    ...overrides.proxy !== void 0 ? { proxy: overrides.proxy } : {},
     defaultBranch: config.repo?.defaultBranch ?? "main",
     tokensRoot: config.tokens?.root ?? "packages/tokens/src",
     product,
@@ -67,7 +110,7 @@ function buildFromConfig(raw, ds, product, overrides = {}) {
   };
 }
 const cacheKey = (ds) => `bridge-toolbar:config:v1:${ds}`;
-async function loadBuild(ds, product, overrides = {}) {
+async function loadBuild(ds, product, overrides = {}, gh) {
   let config = null;
   try {
     const cached = window.sessionStorage.getItem(cacheKey(ds));
@@ -76,9 +119,12 @@ async function loadBuild(ds, product, overrides = {}) {
   }
   if (!config) {
     if (!REPO.test(ds)) throw new Error(`"${ds}" is not a GitHub repository (owner/name).`);
-    const r = await fetch(`https://raw.githubusercontent.com/${ds}/HEAD/bridge.config.json`);
-    if (!r.ok) throw new Error(`Could not read bridge.config.json from ${ds} (GitHub answered ${r.status}).`);
-    config = await r.json();
+    const [owner, name] = ds.split("/");
+    const reads = githubReads({ team: ds, proxy: overrides.proxy === void 0 ? DEFAULT_PROXY : overrides.proxy });
+    const text = await reads.file(owner, name, null, "bridge.config.json").catch((e) => {
+      throw new Error(`Could not read bridge.config.json from ${ds} (${e.message})`);
+    });
+    config = JSON.parse(text);
     try {
       window.sessionStorage.setItem(cacheKey(ds), JSON.stringify(config));
     } catch {
@@ -90,8 +136,10 @@ async function loadBuild(ds, product, overrides = {}) {
 }
 export {
   BridgeToolbar as B,
+  DEFAULT_PROXY as D,
   buildFromConfig as b,
+  githubReads as g,
   loadBuild as l,
   useDocumentScope as u
 };
-//# sourceMappingURL=index-yvFRSnsp.js.map
+//# sourceMappingURL=index-3f0I3tAL.js.map

package/dist/index-3f0I3tAL.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-3f0I3tAL.js","sources":["../src/BridgeToolbar.tsx","../src/scope.ts","../src/reads.ts","../src/config.ts"],"sourcesContent":["// The one line a product mounts at its root: <BridgeToolbar ds=\"owner/design-system\" product=\"checkout\" />. It renders\n// nothing and loads nothing unless Bridge Studio opened the page with `?bridge=<change>` (kept for the session), then\n// loads the toolbar itself as one lazy chunk, with its styles.\nimport { lazy, Suspense, useState } from 'react';\nimport { readChanges, type BridgeBuild } from './session';\nimport type { ToolbarScope, ToolbarShop } from './scope';\nimport type { TogetherBase } from './together';\n\nexport interface BridgeToolbarProps {\n  /** The design system repository, \"owner/name\". The toolbar reads its bridge.config.json when Studio opens the page. */\n  ds?: string;\n  /** This product's key in the design system's bridge.config.json products[] (\"checkout\"). */\n  product?: string;\n  /** Overrides of what the config says: production Studio, this product in production, its preview template. */\n  studio?: string | null;\n  production?: string | null;\n  preview?: string | null;\n  /**\n   * Bridge's origin, whose read proxy serves the toolbar's GitHub reads (no limit of 60 an hour per visitor). Default\n   * production Bridge (https://bridge.floriangouloubi.com); null reads GitHub directly. GitHub directly anyway when\n   * Bridge refuses or cannot be reached.\n   */\n  proxy?: string | null;\n  /** The deploy environment (\"production\", \"preview\"), when the host tells it at build time (VERCEL_ENV). */\n  deployEnv?: string | null;\n  /** Every fact at once, read at build time: no config read at run time (the Admin demo passes it). */\n  build?: BridgeBuild;\n  /** A hook that says where the page is and moves it (theme, shop). Default: the attributes ThemeProvider sets on <html>. */\n  scope?: () => ToolbarScope;\n  /** The shops of a multi-brand product, for the screens list and \"Switch to <shop>\". */\n  shops?: ToolbarShop[];\n  /** The latest library's token files as a combination base: lets Studio's \"Try them together\" run here. */\n  together?: () => Promise<TogetherBase>;\n}\n\nconst Toolbar = lazy(() => import('./Toolbar'));\n\nfunction asked(): boolean {\n  let store: Storage | null = null;\n  try {\n    store = window.sessionStorage;\n  } catch {\n    store = null;\n  }\n  return readChanges(window.location.search, store).length > 0;\n}\n\n/** Mounted once at the app root. Without a change from Studio it renders nothing and loads nothing. */\nexport function BridgeToolbar(props: BridgeToolbarProps) {\n  const [on] = useState(() => typeof window !== 'undefined' && asked());\n  if (!on) return null;\n  return (\n    <Suspense fallback={null}>\n      <Toolbar {...props} />\n    </Suspense>\n  );\n}\n","// Where the page is (theme, brand, density, shop) and how the toolbar moves it there. A product passes its own hook\n// when it keeps these in state (the Admin demo's preferences); by default the toolbar reads the attributes the\n// design system's ThemeProvider (asRoot) puts on <html> and sets data-theme there.\nimport { useEffect, useMemo, useState } from 'react';\n\nexport interface ToolbarScope {\n  theme: 'light' | 'dark';\n  brand: string;\n  density: string;\n  /** The shop (tenant) the page shows, when the product has several. */\n  shop?: string;\n  /** Moves the page to a theme, a shop or both, in one step. */\n  set: (next: { theme?: 'light' | 'dark'; shop?: string }) => void;\n}\n\n/** A shop of a multi-brand product: its id (in `?tenant=` links), its name and its brand. */\nexport interface ToolbarShop {\n  id: string;\n  name: string;\n  brand: string;\n}\n\nconst read = () => {\n  const el = document.documentElement;\n  return {\n    theme: (el.getAttribute('data-theme') === 'dark' ? 'dark' : 'light') as 'light' | 'dark',\n    brand: el.getAttribute('data-brand') || 'bridge',\n    density: el.getAttribute('data-density') || 'comfortable',\n  };\n};\n\n/** The default scope: <html data-theme data-brand data-density>, kept in sync. */\nexport function useDocumentScope(): ToolbarScope {\n  const [here, setHere] = useState(read);\n  useEffect(() => {\n    const mo = new MutationObserver(() => setHere((p) => {\n      const n = read();\n      return n.theme === p.theme && n.brand === p.brand && n.density === p.density ? p : n;\n    }));\n    mo.observe(document.documentElement, { attributes: true, attributeFilter: ['data-theme', 'data-brand', 'data-density'] });\n    return () => mo.disconnect();\n  }, []);\n  return useMemo(\n    () => ({\n      ...here,\n      set: (next) => {\n        if (next.theme) document.documentElement.setAttribute('data-theme', next.theme);\n      },\n    }),\n    [here],\n  );\n}\n","// How the toolbar reads GitHub: through Bridge's read proxy (GET <proxy>/api/contribute?repo=<design system>&gh=<path>,\n// allow-listed, cached, with a read-only token on the server), so a visitor never meets GitHub's limit of 60 anonymous\n// reads an hour per address. When Bridge refuses or cannot be reached (an older Bridge, a design system it does not\n// serve, an origin its config does not name), the toolbar reads GitHub directly, as before, for the rest of the page.\n// The requests stay \"simple\" (GET, Accept only, no credentials): no CORS preflight, no cookie sent.\n\n/** Production Bridge: the read proxy the toolbar uses unless the product says otherwise. */\nexport const DEFAULT_PROXY = 'https://bridge.floriangouloubi.com';\n\nconst API = 'https://api.github.com';\nconst RAW = 'https://raw.githubusercontent.com';\n\nexport interface ReadsOptions {\n  /** The design system repository (\"owner/name\"): Bridge serves its reads and those of the products it lists. */\n  team: string;\n  /** Bridge's origin, or null to read GitHub directly. */\n  proxy: string | null;\n  fetch?: typeof fetch;\n}\n\nexport interface Reads {\n  /** A GitHub REST read under /repos/<owner>/<name>/..., as JSON. */\n  api<T>(path: string): Promise<T>;\n  /** A file of a repository at a ref (a sha or a branch; none: the default branch), as text. */\n  file(owner: string, repo: string, ref: string | null, path: string): Promise<string>;\n}\n\nexport class ReadError extends Error {\n  constructor(\n    message: string,\n    readonly status: number,\n  ) {\n    super(message);\n  }\n}\n\nconst LIMIT = 'GitHub limits reads without an account to 60 an hour. Try again later.';\nconst errorOf = (status: number) => new ReadError(status === 403 || status === 429 ? LIMIT : `GitHub answered ${status}.`, status);\n\n/** Proxies that refused or did not answer on this page: every later read goes to GitHub directly. */\nconst down = new Set<string>();\n\n/** Tests start fresh. */\nexport function resetReads() {\n  down.clear();\n}\n\n/**\n * Bridge's answer is GitHub's when it read GitHub (any status but its own refusals). Its own: 400 (a path it does not\n * take), 401 (no reader), 403 (not allowed, origin), 409 (app missing), 429 (busy), 5xx; then GitHub directly.\n */\nconst proxyRefused = (r: Response) => r.status === 400 || r.status === 401 || r.status === 403 || r.status === 409 || r.status === 429 || r.status >= 500;\n\nconst segments = (path: string) => path.split('/').map(encodeURIComponent).join('/');\n\nexport function githubReads({ team, proxy, fetch: f = (...a) => fetch(...a) }: ReadsOptions): Reads {\n  const base = proxy ? proxy.replace(/\\/+$/, '') : null;\n\n  /** Bridge first, then GitHub. `direct` is GitHub's own URL for the same read. */\n  async function read(gh: string, accept: string, direct: string): Promise<Response> {\n    if (base && !down.has(base)) {\n      try {\n        const r = await f(`${base}/api/contribute?repo=${encodeURIComponent(team)}&gh=${encodeURIComponent(gh)}`, { headers: { Accept: accept }, credentials: 'omit' });\n        if (!proxyRefused(r)) return r;\n      } catch {\n        // Unreachable, or the browser refused the answer (CORS): GitHub directly.\n      }\n      down.add(base);\n    }\n    return f(direct, direct.startsWith(API) ? { headers: { Accept: accept } } : {});\n  }\n\n  return {\n    async api<T>(path: string): Promise<T> {\n      const r = await read(path, 'application/vnd.github+json', `${API}${path}`);\n      if (!r.ok) throw errorOf(r.status);\n      return (await r.json()) as T;\n    },\n    async file(owner, repo, ref, path) {\n      const gh = `/repos/${owner}/${repo}/contents/${segments(path)}${ref ? `?ref=${encodeURIComponent(ref)}` : ''}`;\n      const r = await read(gh, 'application/vnd.github.raw', `${RAW}/${owner}/${repo}/${ref ?? 'HEAD'}/${segments(path)}`);\n      if (!r.ok) throw errorOf(r.status);\n      return r.text();\n    },\n  };\n}\n","// Where a product's toolbar gets its facts when it is mounted with only the design system repository and its product\n// key: the design system's bridge.config.json, read once per session through Bridge's read proxy (GitHub directly when\n// Bridge refuses; public repositories, no account). Pure part (buildFromConfig) is tested; loadBuild adds the read and\n// the session cache.\nimport { DEFAULT_PROXY, githubReads, type Reads } from './reads';\nimport type { BridgeBuild } from './session';\n\ninterface ConfigLike {\n  repo?: { owner?: string; name?: string; defaultBranch?: string };\n  tokens?: { root?: string };\n  previews?: { apps?: Record<string, string | undefined>; production?: Record<string, string | undefined> };\n  products?: { key?: string; repo?: string; preview?: string; production?: string }[];\n}\n\n/** Values the product sets itself win over the config: the Studio, production and preview URLs. */\nexport interface BuildOverrides {\n  studio?: string | null;\n  production?: string | null;\n  preview?: string | null;\n  deployEnv?: string | null;\n  /** Bridge's origin for reads (default production Bridge), null to read GitHub directly. */\n  proxy?: string | null;\n}\n\nconst REPO = /^[\\w.-]+\\/[\\w.-]+$/;\n\n/**\n * The toolbar's facts for one product of a design system config: its repository (its own, else the design system's),\n * production Studio, its production URL and preview template. Null when the product is not in the config.\n */\nexport function buildFromConfig(raw: unknown, ds: string, product: string, overrides: BuildOverrides = {}): BridgeBuild | null {\n  if (!raw || typeof raw !== 'object' || !REPO.test(ds)) return null;\n  const config = raw as ConfigLike;\n  const entry = (config.products ?? []).find((p) => p?.key === product);\n  if (!entry) return null;\n  const own = entry.repo && REPO.test(entry.repo) ? entry.repo : null;\n  const [owner, repo] = (own ?? ds).split('/') as [string, string];\n  const pick = (v: string | null | undefined, fallback: string | null | undefined) => (v !== undefined ? v : (fallback ?? null));\n  return {\n    owner,\n    repo,\n    studio: pick(overrides.studio, config.previews?.production?.docs),\n    production: pick(overrides.production, entry.production ?? config.previews?.production?.[product]),\n    preview: pick(overrides.preview, entry.preview ?? config.previews?.apps?.[product]),\n    deployEnv: overrides.deployEnv ?? null,\n    ...(overrides.proxy !== undefined ? { proxy: overrides.proxy } : {}),\n    defaultBranch: config.repo?.defaultBranch ?? 'main',\n    tokensRoot: config.tokens?.root ?? 'packages/tokens/src',\n    product,\n    ds,\n  };\n}\n\nconst cacheKey = (ds: string) => `bridge-toolbar:config:v1:${ds}`;\n\n/** Reads the design system's bridge.config.json (its default branch), kept for the session. */\nexport async function loadBuild(ds: string, product: string, overrides: BuildOverrides = {}, gh?: Reads): Promise<BridgeBuild> {\n  let config: unknown = null;\n  try {\n    const cached = window.sessionStorage.getItem(cacheKey(ds));\n    if (cached) config = JSON.parse(cached);\n  } catch {\n    // Storage blocked or a broken entry: read it again.\n  }\n  if (!config) {\n    if (!REPO.test(ds)) throw new Error(`\"${ds}\" is not a GitHub repository (owner/name).`);\n    const [owner, name] = ds.split('/') as [string, string];\n    const reads = gh ?? githubReads({ team: ds, proxy: overrides.proxy === undefined ? DEFAULT_PROXY : overrides.proxy });\n    const text = await reads.file(owner, name, null, 'bridge.config.json').catch((e: Error) => {\n      throw new Error(`Could not read bridge.config.json from ${ds} (${e.message})`);\n    });\n    config = JSON.parse(text);\n    try {\n      window.sessionStorage.setItem(cacheKey(ds), JSON.stringify(config));\n    } catch {\n      // Storage blocked: the next page reads it again.\n    }\n  }\n  const build = buildFromConfig(config, ds, product, overrides);\n  if (!build) throw new Error(`No product \"${product}\" in ${ds}'s bridge.config.json.`);\n  return build;\n}\n"],"names":["read"],"mappings":"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"}

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export { BridgeToolbar, type BridgeToolbarProps } from './BridgeToolbar';
 export { useDocumentScope, type ToolbarScope, type ToolbarShop } from './scope';
 export { buildFromConfig, type BuildOverrides } from './config';
+export { DEFAULT_PROXY } from './reads';
 export type { BridgeBuild } from './session';
 export type { TogetherBase } from './together';

package/dist/index.js

@@ -1,6 +1,7 @@
-import { B, b, u } from "./index-yvFRSnsp.js";
+import { B, D, b, u } from "./index-3f0I3tAL.js";
 export {
   B as BridgeToolbar,
+  D as DEFAULT_PROXY,
   b as buildFromConfig,
   u as useDocumentScope
 };

package/dist/reads.d.ts

@@ -0,0 +1,22 @@
+/** Production Bridge: the read proxy the toolbar uses unless the product says otherwise. */
+export declare const DEFAULT_PROXY = "https://bridge.floriangouloubi.com";
+export interface ReadsOptions {
+    /** The design system repository ("owner/name"): Bridge serves its reads and those of the products it lists. */
+    team: string;
+    /** Bridge's origin, or null to read GitHub directly. */
+    proxy: string | null;
+    fetch?: typeof fetch;
+}
+export interface Reads {
+    /** A GitHub REST read under /repos/<owner>/<name>/..., as JSON. */
+    api<T>(path: string): Promise<T>;
+    /** A file of a repository at a ref (a sha or a branch; none: the default branch), as text. */
+    file(owner: string, repo: string, ref: string | null, path: string): Promise<string>;
+}
+export declare class ReadError extends Error {
+    readonly status: number;
+    constructor(message: string, status: number);
+}
+/** Tests start fresh. */
+export declare function resetReads(): void;
+export declare function githubReads({ team, proxy, fetch: f }: ReadsOptions): Reads;

package/dist/session-CzlIsFDY.js.map

@@ -1 +1 @@
-{"version":3,"file":"session-CzlIsFDY.js","sources":["../src/session.ts"],"sourcesContent":["// The Bridge toolbar's pure logic: when it shows, which change it follows, what Before and After mean for that\n// change, and the screens it lists. A product opens it only when Bridge Studio links here with `?bridge=<change>`;\n// production renders nothing, except the Before side of a code change, which arrives with a handoff from a preview.\n\nexport interface StorageLike {\n  getItem(key: string): string | null;\n  setItem(key: string, value: string): void;\n  removeItem(key: string): void;\n}\n\n/**\n * What the toolbar knows about the product and its design system: from bridge.config.json (the product's entry in\n * products[] and previews), read at build time (the Admin demo) or from the design system repository at run time.\n */\nexport interface BridgeBuild {\n  /** The repository whose pull requests `?bridge=<n>` names: the product's own repository, else the design system's. */\n  owner: string;\n  repo: string;\n  /** Production Studio (previews.production.docs): the link back and the shipped tokens.css. */\n  studio: string | null;\n  /** The product in production (products[].production, else previews.production.<key>): Before of a code change. */\n  production: string | null;\n  /** The product's preview template (products[].preview): only these hosts may hand a code change over to production. */\n  preview: string | null;\n  /** VERCEL_ENV of the build ('production', 'preview', 'development'), null when unknown. */\n  deployEnv: string | null;\n  /** The library branch (repo.defaultBranch) and the token files' root (tokens.root): changes tried together. */\n  defaultBranch?: string;\n  tokensRoot?: string;\n  /** The product's key (products[].key) and the design system repository (\"owner/name\"), for the way back to Studio. */\n  product?: string;\n  ds?: string;\n}\n\nexport const PARAM = 'bridge';\n/** Where After lives for a code change, carried to production on Before. */\nexport const RETURN_PARAM = 'bridge-return';\n/** Scroll position carried across a Before/After navigation. */\nexport const SCROLL_PARAM = 'bridge-scroll';\nexport const SESSION_KEY = 'bridge-admin:change';\nexport const RETURN_KEY = 'bridge-admin:return';\nexport const DOCK_KEY = 'bridge-admin:toolbar-dock';\nexport const OPEN_KEY = 'bridge-admin:toolbar-open';\n/** Changes tried together: the picks of the tokens they set differently (core encodePicks), from Studio. */\nexport const USE_PARAM = 'bridge-use';\nexport const USE_KEY = 'bridge-admin:use';\n/** At most this many changes are tried together. */\nexport const MAX_TOGETHER = 4;\n\nconst safe = <T>(fn: () => T, fallback: T): T => {\n  try {\n    return fn();\n  } catch {\n    return fallback;\n  }\n};\n\n/**\n * The change the toolbar follows: `?bridge=<n>` wins and is kept for the session (the admin's hash router keeps the\n * query, a reload or a new path does not need it again); `?bridge=off` forgets it. Blocked storage only loses the\n * memory, never the toolbar of the current page.\n */\nexport function readChange(search: string, storage: StorageLike | null): number | null {\n  return readChanges(search, storage)[0] ?? null;\n}\n\n/**\n * The change numbers in \"101\" or \"101,118,120\" (an encoded comma too): positive, at most 7 digits, no repeats, at\n * most MAX_TOGETHER. Anything else in the list makes it unreadable (empty), never a guess.\n */\nexport function parseChanges(raw: string | null | undefined): number[] {\n  const parts = (raw ?? '').trim().split(/,|%2C/i).map((p) => p.trim());\n  if (!parts.every((p) => /^\\d{1,7}$/.test(p) && Number(p) > 0)) return [];\n  return [...new Set(parts.map(Number))].slice(0, MAX_TOGETHER);\n}\n\n/**\n * The changes the toolbar follows: one from \"Try it in the product\", 2 to 4 from \"Try them together\". Same memory as\n * one change: `?bridge=` wins and is kept for the session, `?bridge=off` forgets it, blocked storage only loses the\n * memory. The picks (`bridge-use`) travel with the list and are kept, or forgotten, with it.\n */\nexport function readChanges(search: string, storage: StorageLike | null): number[] {\n  const params = new URLSearchParams(search);\n  if (params.has(PARAM)) {\n    const list = parseChanges(params.get(PARAM));\n    if (!list.length) {\n      if (storage) safe(() => (storage.removeItem(SESSION_KEY), storage.removeItem(USE_KEY)), undefined);\n      return [];\n    }\n    if (storage) {\n      safe(() => storage.setItem(SESSION_KEY, list.join(',')), undefined);\n      const use = params.get(USE_PARAM);\n      safe(() => (use && list.length > 1 ? storage.setItem(USE_KEY, use) : storage.removeItem(USE_KEY)), undefined);\n    }\n    return list;\n  }\n  return storage ? parseChanges(safe(() => storage.getItem(SESSION_KEY), null)) : [];\n}\n\n/** The picks that came with the list: from the address, else the session. */\nexport function readUse(search: string, storage: StorageLike | null): string | null {\n  const params = new URLSearchParams(search);\n  if (params.has(PARAM)) return params.get(USE_PARAM);\n  return storage ? safe(() => storage.getItem(USE_KEY), null) : null;\n}\n\n/** A host that matches the product's preview template (`bridge-admin-git-{branch}-team.vercel.app`), https only. */\nexport function isPreviewUrl(raw: string | null | undefined, template: string | null): boolean {\n  if (!raw || !template) return false;\n  let url: URL;\n  let tpl: URL;\n  try {\n    url = new URL(raw);\n    tpl = new URL(template.replace(/\\{[a-z]+\\}/gi, 'x'));\n  } catch {\n    return false;\n  }\n  if (url.protocol !== 'https:' || url.username || url.password || url.port) return false;\n  const tplHost = /^https?:\\/\\/([^/?#]+)/i.exec(template)?.[1]?.toLowerCase();\n  if (!tplHost || tpl.protocol !== 'https:') return false;\n  const pattern = new RegExp(`^${tplHost.split(/\\{[a-z]+\\}/i).map((p) => p.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&')).join('[a-z0-9-]+')}$`);\n  return pattern.test(url.hostname.toLowerCase());\n}\n\n/** The preview to return to from production, from `?bridge-return=` or the session. Only a preview host counts. */\nexport function readReturn(search: string, storage: StorageLike | null, template: string | null): string | null {\n  const raw = new URLSearchParams(search).get(RETURN_PARAM);\n  if (raw !== null) {\n    if (isPreviewUrl(raw, template)) {\n      const origin = new URL(raw).origin;\n      if (storage) safe(() => storage.setItem(RETURN_KEY, origin), undefined);\n      return origin;\n    }\n    return null;\n  }\n  const stored = storage ? safe(() => storage.getItem(RETURN_KEY), null) : null;\n  return isPreviewUrl(stored, template) ? new URL(stored!).origin : null;\n}\n\nexport type Where = 'production' | 'preview' | 'local';\n\n/** Which deployment this page is: the product in production by host or by build, a preview, or a local build. */\nexport function whereAmI(host: string, build: Pick<BridgeBuild, 'production' | 'deployEnv'>): Where {\n  const prodHost = build.production ? safe(() => new URL(build.production!).host, null) : null;\n  if (build.deployEnv === 'production' || (prodHost && host.toLowerCase() === prodHost.toLowerCase())) return 'production';\n  if (build.deployEnv === 'preview') return 'preview';\n  return 'local';\n}\n\n/**\n * Whether the toolbar renders. Never without a change from Studio. In production only for the Before side of a code\n * change, that is with a preview to return to: production on its own renders nothing.\n */\nexport function shouldRender(input: { change: number | null; where: Where; returnTo: string | null; together?: boolean }): boolean {\n  if (input.change === null) return false;\n  // Changes tried together run on production: no preview holds all of them.\n  if (input.together) return true;\n  if (input.where === 'production') return input.returnTo !== null;\n  return true;\n}\n\n/** \"These 3 changes\": the After side of changes tried together, counting the ones switched on. */\nexport const togetherLabel = (n: number) => (n === 1 ? 'This change' : `These ${n} changes`);\n\n/** The one hint line of changes tried together: where they run and why. */\nexport const TOGETHER_HINT = \"The live product, with these changes' tokens applied in your browser only. No preview has all of them together.\";\n\n/** Show what changed found nothing on this screen for changes tried together. */\nexport const TOGETHER_EMPTY_LINE = \"These changes don't touch this screen. Try another screen.\";\n\n/** Switches one change on or off, keeping the order Studio listed them in. */\nexport function toggleIncluded(all: number[], included: number[], n: number, on: boolean): number[] {\n  const next = new Set(included);\n  if (on) next.add(n);\n  else next.delete(n);\n  return all.filter((x) => next.has(x));\n}\n\n/** Studio's Changes list, where changes are tried together (and the way back). */\nexport function studioChangesUrl(build: Pick<BridgeBuild, 'studio' | 'owner' | 'repo'>): string {\n  return build.studio ? `${build.studio.replace(/\\/$/, '')}/studio/changes/` : `https://github.com/${build.owner}/${build.repo}/pulls`;\n}\n\nexport type ChangeMode = 'tokens' | 'code';\n\n/** Token files (DTCG and the contrast gate) and changesets only: Before swaps tokens live. Anything else is code. */\nexport function changeMode(files: string[]): ChangeMode {\n  const tokenOnly = files.length > 0 && files.every((f) => f.endsWith('.tokens.json') || /contrast\\.checks\\.json$/.test(f) || f.startsWith('.changeset/'));\n  return tokenOnly ? 'tokens' : 'code';\n}\n\n/** The live tokens (main's build, served by production Studio at `/tokens.css`), or null when not configured. */\nexport function liveTokensUrl(build: Pick<BridgeBuild, 'studio'>): string | null {\n  return build.studio ? safe(() => new URL('tokens.css', build.studio!.replace(/\\/?$/, '/')).href, null) : null;\n}\n\n/**\n * Studio's page for the change. A change in a product's own repository (an exploration there) opens as\n * `?exploration=<n>&product=<key>`; a change of the design system repository as `?pr=<n>`.\n */\nexport function studioChangeUrl(build: Pick<BridgeBuild, 'studio' | 'owner' | 'repo' | 'product' | 'ds'>, change: number): string {\n  if (!build.studio) return `https://github.com/${build.owner}/${build.repo}/pull/${change}`;\n  const studio = build.studio.replace(/\\/$/, '');\n  const own = build.product && build.ds && build.ds.toLowerCase() !== `${build.owner}/${build.repo}`.toLowerCase();\n  return own ? `${studio}/studio/changes/?exploration=${change}&product=${encodeURIComponent(build.product!)}` : `${studio}/studio/changes/?pr=${change}`;\n}\n\n/** Shape of a visual impact manifest that the toolbar reads (written by @bridge-ds/visual). */\nexport interface ManifestShot {\n  kind: 'story' | 'route';\n  label: string;\n  route?: string;\n  tenant?: string;\n  theme: string;\n  status: string;\n  percent: number;\n}\n\nexport interface Screen {\n  label: string;\n  route: string;\n  tenant: string;\n  theme: string;\n  percent: number;\n}\n\n/** The product screens the change alters, most changed first, one entry per screen, shop and theme. */\nexport function changedScreens(shots: ManifestShot[] | null | undefined): Screen[] {\n  if (!Array.isArray(shots)) return [];\n  const seen = new Set<string>();\n  return shots\n    .filter((s) => s.kind === 'route' && s.route && s.tenant && (s.status === 'changed' || s.status === 'added'))\n    .sort((a, b) => b.percent - a.percent)\n    .filter((s) => {\n      const key = `${s.route}|${s.tenant}|${s.theme}`;\n      if (seen.has(key)) return false;\n      seen.add(key);\n      return true;\n    })\n    .map((s) => ({ label: s.label, route: s.route!, tenant: s.tenant!, theme: s.theme, percent: s.percent }));\n}\n\n/**\n * The same page on another deployment (code changes: production for Before, the preview for After), with the\n * change, the way back and the scroll position in the query. The hash route (ra-core) is kept.\n */\nexport function sameScreenOn(target: string, here: { search: string; hash: string }, extra: { change: number; returnTo?: string | null; scroll?: number }): string {\n  const url = new URL(target);\n  const params = new URLSearchParams(here.search);\n  params.delete(RETURN_PARAM);\n  params.delete(SCROLL_PARAM);\n  params.set(PARAM, String(extra.change));\n  if (extra.returnTo) params.set(RETURN_PARAM, extra.returnTo);\n  if (extra.scroll && extra.scroll > 0) params.set(SCROLL_PARAM, String(Math.round(extra.scroll)));\n  url.pathname = '/';\n  url.search = params.toString();\n  url.hash = here.hash;\n  return url.href;\n}\n\n/** The scroll position a Before/After navigation carried, once: the caller removes it from the address. */\nexport function readScroll(search: string): number | null {\n  const raw = new URLSearchParams(search).get(SCROLL_PARAM);\n  return raw && /^\\d{1,7}$/.test(raw) ? Number(raw) : null;\n}\n\nexport type Dock = 'start' | 'center' | 'end';\nconst DOCKS: Dock[] = ['start', 'center', 'end'];\n\n/** Bottom right by default: the corner a back office leaves free most often. */\nexport function readDock(storage: StorageLike | null): Dock {\n  const v = storage ? safe(() => storage.getItem(DOCK_KEY), null) : null;\n  return DOCKS.includes(v as Dock) ? (v as Dock) : 'end';\n}\n\n/** One step left (-1) or right (+1), stopping at the edges. */\nexport function stepDock(dock: Dock, step: -1 | 1): Dock {\n  return DOCKS[Math.min(DOCKS.length - 1, Math.max(0, DOCKS.indexOf(dock) + step))]!;\n}\n\n/** The dock nearest to where a drag ended: thirds of the viewport width. */\nexport function dockAt(x: number, width: number): Dock {\n  if (width <= 0) return 'center';\n  const r = x / width;\n  return r < 1 / 3 ? 'start' : r > 2 / 3 ? 'end' : 'center';\n}\n\n/** Title of a change as people read it: conventional prefixes (\"tokens: \") dropped, first letter up. */\nexport function readableTitle(title: string): string {\n  const t = title.replace(/^\\s*[a-z]+(\\([^)]*\\))?!?:\\s*/i, '').trim() || title.trim();\n  return t.charAt(0).toUpperCase() + t.slice(1);\n}\n\n/** The B shortcut flips Before and After, unless the person is typing or holds a modifier. */\nexport function isFlipKey(e: { key: string; altKey: boolean; ctrlKey: boolean; metaKey: boolean; target: unknown }): boolean {\n  if (e.altKey || e.ctrlKey || e.metaKey || e.key.toLowerCase() !== 'b') return false;\n  const t = e.target as { tagName?: string; isContentEditable?: boolean; closest?: (s: string) => unknown } | null;\n  if (!t) return true;\n  if (t.isContentEditable) return false;\n  const tag = (t.tagName ?? '').toLowerCase();\n  if (tag === 'input' || tag === 'textarea' || tag === 'select') return false;\n  return !(t.closest && t.closest('[role=\"combobox\"], [role=\"textbox\"], [role=\"searchbox\"]'));\n}\n\nexport interface Rect {\n  left: number;\n  top: number;\n  right: number;\n  bottom: number;\n}\n\nconst overlaps = (a: Rect, b: Rect, margin: number) => a.left < b.right + margin && a.right > b.left - margin && a.top < b.bottom + margin && a.bottom > b.top - margin;\n\n/**\n * Where the toolbar goes so it never covers a primary or submit button of the page: the chosen dock if it is free,\n * else the opposite corner, else the centre, else the chosen dock lifted just above the buttons it would cover. The\n * docks sit inside the area [left, right] (the content column, so it never sits over the sidebar).\n */\nexport function placeToolbar(input: { left: number; right: number; vh: number; w: number; h: number; gutter: number; preferred: Dock; obstacles: Rect[]; margin?: number }): { dock: Dock; lift: number } {\n  const { left: areaLeft, right: areaRight, vh, w, h, gutter, preferred, obstacles } = input;\n  const margin = input.margin ?? 8;\n  const rectAt = (dock: Dock, lift = 0): Rect => {\n    const left = dock === 'start' ? areaLeft : dock === 'end' ? areaRight - w : (areaLeft + areaRight - w) / 2;\n    const bottom = vh - gutter - lift;\n    return { left, right: left + w, top: bottom - h, bottom };\n  };\n  const opposite: Dock = preferred === 'start' ? 'end' : 'start';\n  const order: Dock[] = [preferred, opposite, ...DOCKS.filter((d) => d !== preferred && d !== opposite)];\n  for (const dock of order) {\n    const r = rectAt(dock);\n    if (!obstacles.some((o) => overlaps(r, o, margin))) return { dock, lift: 0 };\n  }\n  // Every dock covers something: stay put and rise above the highest button in the way.\n  const base = rectAt(preferred);\n  const inWay = obstacles.filter((o) => o.left < base.right + margin && o.right > base.left - margin && o.bottom > base.top - margin);\n  const top = Math.min(...inWay.map((o) => o.top));\n  const lift = Math.max(0, Math.ceil(base.bottom - (top - margin)));\n  return { dock: preferred, lift: Math.min(lift, Math.max(0, vh - h - 2 * gutter)) };\n}\n\n/** What one token file can change on screen: a theme and a brand, or every one of them (null). */\nfunction fileScope(file: string): { theme: string | null; brand: string | null } | 'none' {\n  if (file.startsWith('.changeset/')) return 'none';\n  let m = /(?:^|\\/)semantic\\/([a-z0-9-]+)\\.tokens\\.json$/i.exec(file);\n  if (m && m[1] !== 'base') return { theme: m[1]!, brand: null };\n  m = /(?:^|\\/)brands\\/([a-z0-9-]+)\\.([a-z0-9-]+)\\.tokens\\.json$/i.exec(file);\n  if (m) return { theme: m[2]!, brand: m[1]! };\n  m = /(?:^|\\/)brands\\/([a-z0-9-]+)\\.tokens\\.json$/i.exec(file);\n  if (m) return { theme: null, brand: m[1]! };\n  // Primitives, base, density, components and anything else: could change every theme and brand.\n  return { theme: null, brand: null };\n}\n\nexport type NoDifference = { kind: 'theme'; here: string; touched: string } | { kind: 'brand'; here: string; touched: string };\n\n/**\n * Whether a token change shows nothing in this theme and brand, from the token files it edits (DTCG layers named\n * semantic/<theme>, brands/<brand>.<theme>, brands/<brand>). Null when it may show, or when that cannot be told:\n * never claims \"no difference\" on a guess.\n */\nexport function noVisibleDifference(files: string[], here: { theme: string; brand: string }): NoDifference | null {\n  const scopes = files.map(fileScope).filter((s): s is { theme: string | null; brand: string | null } => s !== 'none');\n  if (!scopes.length) return null;\n  const hits = (theme: string, brand: string) => scopes.some((s) => (s.theme === null || s.theme === theme) && (s.brand === null || s.brand === brand));\n  if (hits(here.theme, here.brand)) return null;\n  const theme = scopes.find((s) => s.theme !== null && s.theme !== here.theme && (s.brand === null || s.brand === here.brand))?.theme;\n  if (theme) return { kind: 'theme', here: here.theme, touched: theme };\n  const brand = scopes.find((s) => s.brand !== null && s.brand !== here.brand)?.brand;\n  return brand ? { kind: 'brand', here: here.brand, touched: brand } : null;\n}\n\n/** \"darker default background.\" The change title as a short phrase after \"This change:\". */\nexport function changeSummary(title: string): string {\n  const t = readableTitle(title).replace(/[.\\s]+$/, '');\n  if (!t) return '';\n  const lower = /^[A-Z][a-z]/.test(t) ? t.charAt(0).toLowerCase() + t.slice(1) : t;\n  return `${lower}.`;\n}\n\nexport interface TokenChange {\n  /** Token path, \"color.bg.default\". */\n  path: string;\n  /** CSS variable the token builds to, \"--color-bg-default\". */\n  cssVar: string;\n  /** The role it plays, what designers call it: \"Page canvas\" (its description), \"Brand primary\" (a palette role). */\n  name: string;\n  /** The exact step, second: \"Primary 700\" for a palette step, null for a semantic token. */\n  step: string | null;\n  type: string | null;\n  /** The theme and brand its file applies to (null: every one). */\n  theme: string | null;\n  brand: string | null;\n}\n\ntype TokenNode = { $value?: unknown; $type?: string; $description?: string; [k: string]: unknown };\ntype Leaf = { value: string; type: string | null; description: string | null };\n\nfunction leaves(node: unknown, path: string[] = [], inheritedType: string | null = null, out = new Map<string, Leaf>()): Map<string, Leaf> {\n  if (!node || typeof node !== 'object') return out;\n  const n = node as TokenNode;\n  const type = typeof n.$type === 'string' ? n.$type : inheritedType;\n  if ('$value' in n) {\n    out.set(path.join('.'), { value: JSON.stringify(n.$value), type, description: typeof n.$description === 'string' ? n.$description : null });\n    return out;\n  }\n  for (const [k, v] of Object.entries(n)) if (!k.startsWith('$')) leaves(v, [...path, k], type, out);\n  return out;\n}\n\n/** Palette roles a brand re-points (brands/<brand>.tokens.json), in designers' words. */\nconst PALETTE_ROLES: Record<string, string> = { primary: 'Brand primary', link: 'Link', neutral: 'Neutral', accent: 'Accent', success: 'Success', warning: 'Warning', danger: 'Danger', info: 'Info', categorical: 'Chart colours' };\n\n/** The role a token plays: its description's first phrase, a palette role (\"Brand primary\"), else its path in words. */\nexport function roleOfToken(path: string, description: string | null): string {\n  const first = description?.split(/[.:;(]/)[0]?.trim();\n  if (first && first.length <= 40) return first;\n  const m = /^palette\\.([a-z-]+)\\./.exec(path);\n  if (m) return PALETTE_ROLES[m[1]!] ?? designerName(`palette.${m[1]}`, null);\n  return designerName(path, null);\n}\n\n/** The palette step, shown second: \"palette.primary.700\" -> \"Primary 700\"; null for other tokens. */\nexport function stepOfToken(path: string): string | null {\n  return path.startsWith('palette.') ? designerName(path, null) : null;\n}\n\n/** Designer name of a token: the first phrase of its description, else its path in words (\"Bg default\"). */\nexport function designerName(path: string, description: string | null): string {\n  const first = description?.split(/[.:;(]/)[0]?.trim();\n  if (first && first.length <= 40) return first;\n  const words = path.replace(/^(color|palette)\\./, '').split('.').join(' ');\n  return words.charAt(0).toUpperCase() + words.slice(1);\n}\n\n/**\n * The tokens one file changes between two versions of it (parsed DTCG JSON, null when the file is added or removed):\n * every leaf whose $value differs, with the theme and brand its layer applies to.\n */\nexport function tokenChanges(file: string, before: unknown, after: unknown): TokenChange[] {\n  const scope = fileScope(file);\n  if (scope === 'none') return [];\n  const a = leaves(before);\n  const b = leaves(after);\n  const out: TokenChange[] = [];\n  for (const path of new Set([...a.keys(), ...b.keys()])) {\n    const x = a.get(path);\n    const y = b.get(path);\n    if (x?.value === y?.value) continue;\n    out.push({\n      path,\n      cssVar: `--${path.split('.').join('-')}`,\n      name: roleOfToken(path, y?.description ?? x?.description ?? null),\n      step: stepOfToken(path),\n      type: y?.type ?? x?.type ?? null,\n      theme: scope.theme,\n      brand: scope.brand,\n    });\n  }\n  return out;\n}\n\n/** WCAG contrast ratio between two rgb() colours, or null when either is not rgb (a non-colour value). */\nexport function contrastRatio(a: string, b: string): number | null {\n  const lum = (c: string) => {\n    const m = /^rgba?\\((\\d+),\\s*(\\d+),\\s*(\\d+)/.exec(c.trim());\n    if (!m) return null;\n    const [r, g, bl] = [m[1], m[2], m[3]].map((n) => {\n      const v = Number(n) / 255;\n      return v <= 0.03928 ? v / 12.92 : ((v + 0.055) / 1.055) ** 2.4;\n    }) as [number, number, number];\n    return 0.2126 * r + 0.7152 * g + 0.0722 * bl;\n  };\n  const x = lum(a);\n  const y = lum(b);\n  if (x === null || y === null) return null;\n  return (Math.max(x, y) + 0.05) / (Math.min(x, y) + 0.05);\n}\n\n/** Two colours under 1.1:1 read as the same at a glance: the swatch says \"Subtle change\" so it does not look broken. */\nexport const isSubtle = (a: string, b: string): boolean => {\n  const r = contrastRatio(a, b);\n  return r !== null && r < 1.1;\n};\n\n/** rgb(245, 247, 249) -> #f5f7f9; anything else as is. */\nexport function toHex(color: string): string {\n  const m = /^rgba?\\((\\d+),\\s*(\\d+),\\s*(\\d+)(?:,\\s*([\\d.]+))?\\)$/.exec(color.trim());\n  if (!m) return color;\n  const hex = [m[1], m[2], m[3]].map((n) => Number(n).toString(16).padStart(2, '0')).join('');\n  return m[4] !== undefined && Number(m[4]) < 1 ? `#${hex}${Math.round(Number(m[4]) * 255).toString(16).padStart(2, '0')}` : `#${hex}`;\n}\n\n/** \"from Darker default background\", \"from #101 and #118\": which change a token's value comes from (changes tried together). */\nexport function fromText(from: number[], titleOf: (n: number) => string | null): string {\n  const names = from.map((n) => titleOf(n) ?? `#${n}`);\n  return `from ${names.length <= 2 ? names.join(' and ') : `${names.slice(0, -1).join(', ')} and ${names[names.length - 1]}`}`;\n}\n"],"names":["lift","theme","brand"],"mappings":"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"}
+{"version":3,"file":"session-CzlIsFDY.js","sources":["../src/session.ts"],"sourcesContent":["// The Bridge toolbar's pure logic: when it shows, which change it follows, what Before and After mean for that\n// change, and the screens it lists. A product opens it only when Bridge Studio links here with `?bridge=<change>`;\n// production renders nothing, except the Before side of a code change, which arrives with a handoff from a preview.\n\nexport interface StorageLike {\n  getItem(key: string): string | null;\n  setItem(key: string, value: string): void;\n  removeItem(key: string): void;\n}\n\n/**\n * What the toolbar knows about the product and its design system: from bridge.config.json (the product's entry in\n * products[] and previews), read at build time (the Admin demo) or from the design system repository at run time.\n */\nexport interface BridgeBuild {\n  /** The repository whose pull requests `?bridge=<n>` names: the product's own repository, else the design system's. */\n  owner: string;\n  repo: string;\n  /** Production Studio (previews.production.docs): the link back and the shipped tokens.css. */\n  studio: string | null;\n  /** The product in production (products[].production, else previews.production.<key>): Before of a code change. */\n  production: string | null;\n  /** The product's preview template (products[].preview): only these hosts may hand a code change over to production. */\n  preview: string | null;\n  /** VERCEL_ENV of the build ('production', 'preview', 'development'), null when unknown. */\n  deployEnv: string | null;\n  /** The library branch (repo.defaultBranch) and the token files' root (tokens.root): changes tried together. */\n  defaultBranch?: string;\n  tokensRoot?: string;\n  /** The product's key (products[].key) and the design system repository (\"owner/name\"), for the way back to Studio. */\n  product?: string;\n  ds?: string;\n  /** Bridge's origin for GitHub reads (its read proxy); default production Bridge, null to read GitHub directly. */\n  proxy?: string | null;\n}\n\nexport const PARAM = 'bridge';\n/** Where After lives for a code change, carried to production on Before. */\nexport const RETURN_PARAM = 'bridge-return';\n/** Scroll position carried across a Before/After navigation. */\nexport const SCROLL_PARAM = 'bridge-scroll';\nexport const SESSION_KEY = 'bridge-admin:change';\nexport const RETURN_KEY = 'bridge-admin:return';\nexport const DOCK_KEY = 'bridge-admin:toolbar-dock';\nexport const OPEN_KEY = 'bridge-admin:toolbar-open';\n/** Changes tried together: the picks of the tokens they set differently (core encodePicks), from Studio. */\nexport const USE_PARAM = 'bridge-use';\nexport const USE_KEY = 'bridge-admin:use';\n/** At most this many changes are tried together. */\nexport const MAX_TOGETHER = 4;\n\nconst safe = <T>(fn: () => T, fallback: T): T => {\n  try {\n    return fn();\n  } catch {\n    return fallback;\n  }\n};\n\n/**\n * The change the toolbar follows: `?bridge=<n>` wins and is kept for the session (the admin's hash router keeps the\n * query, a reload or a new path does not need it again); `?bridge=off` forgets it. Blocked storage only loses the\n * memory, never the toolbar of the current page.\n */\nexport function readChange(search: string, storage: StorageLike | null): number | null {\n  return readChanges(search, storage)[0] ?? null;\n}\n\n/**\n * The change numbers in \"101\" or \"101,118,120\" (an encoded comma too): positive, at most 7 digits, no repeats, at\n * most MAX_TOGETHER. Anything else in the list makes it unreadable (empty), never a guess.\n */\nexport function parseChanges(raw: string | null | undefined): number[] {\n  const parts = (raw ?? '').trim().split(/,|%2C/i).map((p) => p.trim());\n  if (!parts.every((p) => /^\\d{1,7}$/.test(p) && Number(p) > 0)) return [];\n  return [...new Set(parts.map(Number))].slice(0, MAX_TOGETHER);\n}\n\n/**\n * The changes the toolbar follows: one from \"Try it in the product\", 2 to 4 from \"Try them together\". Same memory as\n * one change: `?bridge=` wins and is kept for the session, `?bridge=off` forgets it, blocked storage only loses the\n * memory. The picks (`bridge-use`) travel with the list and are kept, or forgotten, with it.\n */\nexport function readChanges(search: string, storage: StorageLike | null): number[] {\n  const params = new URLSearchParams(search);\n  if (params.has(PARAM)) {\n    const list = parseChanges(params.get(PARAM));\n    if (!list.length) {\n      if (storage) safe(() => (storage.removeItem(SESSION_KEY), storage.removeItem(USE_KEY)), undefined);\n      return [];\n    }\n    if (storage) {\n      safe(() => storage.setItem(SESSION_KEY, list.join(',')), undefined);\n      const use = params.get(USE_PARAM);\n      safe(() => (use && list.length > 1 ? storage.setItem(USE_KEY, use) : storage.removeItem(USE_KEY)), undefined);\n    }\n    return list;\n  }\n  return storage ? parseChanges(safe(() => storage.getItem(SESSION_KEY), null)) : [];\n}\n\n/** The picks that came with the list: from the address, else the session. */\nexport function readUse(search: string, storage: StorageLike | null): string | null {\n  const params = new URLSearchParams(search);\n  if (params.has(PARAM)) return params.get(USE_PARAM);\n  return storage ? safe(() => storage.getItem(USE_KEY), null) : null;\n}\n\n/** A host that matches the product's preview template (`bridge-admin-git-{branch}-team.vercel.app`), https only. */\nexport function isPreviewUrl(raw: string | null | undefined, template: string | null): boolean {\n  if (!raw || !template) return false;\n  let url: URL;\n  let tpl: URL;\n  try {\n    url = new URL(raw);\n    tpl = new URL(template.replace(/\\{[a-z]+\\}/gi, 'x'));\n  } catch {\n    return false;\n  }\n  if (url.protocol !== 'https:' || url.username || url.password || url.port) return false;\n  const tplHost = /^https?:\\/\\/([^/?#]+)/i.exec(template)?.[1]?.toLowerCase();\n  if (!tplHost || tpl.protocol !== 'https:') return false;\n  const pattern = new RegExp(`^${tplHost.split(/\\{[a-z]+\\}/i).map((p) => p.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&')).join('[a-z0-9-]+')}$`);\n  return pattern.test(url.hostname.toLowerCase());\n}\n\n/** The preview to return to from production, from `?bridge-return=` or the session. Only a preview host counts. */\nexport function readReturn(search: string, storage: StorageLike | null, template: string | null): string | null {\n  const raw = new URLSearchParams(search).get(RETURN_PARAM);\n  if (raw !== null) {\n    if (isPreviewUrl(raw, template)) {\n      const origin = new URL(raw).origin;\n      if (storage) safe(() => storage.setItem(RETURN_KEY, origin), undefined);\n      return origin;\n    }\n    return null;\n  }\n  const stored = storage ? safe(() => storage.getItem(RETURN_KEY), null) : null;\n  return isPreviewUrl(stored, template) ? new URL(stored!).origin : null;\n}\n\nexport type Where = 'production' | 'preview' | 'local';\n\n/** Which deployment this page is: the product in production by host or by build, a preview, or a local build. */\nexport function whereAmI(host: string, build: Pick<BridgeBuild, 'production' | 'deployEnv'>): Where {\n  const prodHost = build.production ? safe(() => new URL(build.production!).host, null) : null;\n  if (build.deployEnv === 'production' || (prodHost && host.toLowerCase() === prodHost.toLowerCase())) return 'production';\n  if (build.deployEnv === 'preview') return 'preview';\n  return 'local';\n}\n\n/**\n * Whether the toolbar renders. Never without a change from Studio. In production only for the Before side of a code\n * change, that is with a preview to return to: production on its own renders nothing.\n */\nexport function shouldRender(input: { change: number | null; where: Where; returnTo: string | null; together?: boolean }): boolean {\n  if (input.change === null) return false;\n  // Changes tried together run on production: no preview holds all of them.\n  if (input.together) return true;\n  if (input.where === 'production') return input.returnTo !== null;\n  return true;\n}\n\n/** \"These 3 changes\": the After side of changes tried together, counting the ones switched on. */\nexport const togetherLabel = (n: number) => (n === 1 ? 'This change' : `These ${n} changes`);\n\n/** The one hint line of changes tried together: where they run and why. */\nexport const TOGETHER_HINT = \"The live product, with these changes' tokens applied in your browser only. No preview has all of them together.\";\n\n/** Show what changed found nothing on this screen for changes tried together. */\nexport const TOGETHER_EMPTY_LINE = \"These changes don't touch this screen. Try another screen.\";\n\n/** Switches one change on or off, keeping the order Studio listed them in. */\nexport function toggleIncluded(all: number[], included: number[], n: number, on: boolean): number[] {\n  const next = new Set(included);\n  if (on) next.add(n);\n  else next.delete(n);\n  return all.filter((x) => next.has(x));\n}\n\n/** Studio's Changes list, where changes are tried together (and the way back). */\nexport function studioChangesUrl(build: Pick<BridgeBuild, 'studio' | 'owner' | 'repo'>): string {\n  return build.studio ? `${build.studio.replace(/\\/$/, '')}/studio/changes/` : `https://github.com/${build.owner}/${build.repo}/pulls`;\n}\n\nexport type ChangeMode = 'tokens' | 'code';\n\n/** Token files (DTCG and the contrast gate) and changesets only: Before swaps tokens live. Anything else is code. */\nexport function changeMode(files: string[]): ChangeMode {\n  const tokenOnly = files.length > 0 && files.every((f) => f.endsWith('.tokens.json') || /contrast\\.checks\\.json$/.test(f) || f.startsWith('.changeset/'));\n  return tokenOnly ? 'tokens' : 'code';\n}\n\n/** The live tokens (main's build, served by production Studio at `/tokens.css`), or null when not configured. */\nexport function liveTokensUrl(build: Pick<BridgeBuild, 'studio'>): string | null {\n  return build.studio ? safe(() => new URL('tokens.css', build.studio!.replace(/\\/?$/, '/')).href, null) : null;\n}\n\n/**\n * Studio's page for the change. A change in a product's own repository (an exploration there) opens as\n * `?exploration=<n>&product=<key>`; a change of the design system repository as `?pr=<n>`.\n */\nexport function studioChangeUrl(build: Pick<BridgeBuild, 'studio' | 'owner' | 'repo' | 'product' | 'ds'>, change: number): string {\n  if (!build.studio) return `https://github.com/${build.owner}/${build.repo}/pull/${change}`;\n  const studio = build.studio.replace(/\\/$/, '');\n  const own = build.product && build.ds && build.ds.toLowerCase() !== `${build.owner}/${build.repo}`.toLowerCase();\n  return own ? `${studio}/studio/changes/?exploration=${change}&product=${encodeURIComponent(build.product!)}` : `${studio}/studio/changes/?pr=${change}`;\n}\n\n/** Shape of a visual impact manifest that the toolbar reads (written by @bridge-ds/visual). */\nexport interface ManifestShot {\n  kind: 'story' | 'route';\n  label: string;\n  route?: string;\n  tenant?: string;\n  theme: string;\n  status: string;\n  percent: number;\n}\n\nexport interface Screen {\n  label: string;\n  route: string;\n  tenant: string;\n  theme: string;\n  percent: number;\n}\n\n/** The product screens the change alters, most changed first, one entry per screen, shop and theme. */\nexport function changedScreens(shots: ManifestShot[] | null | undefined): Screen[] {\n  if (!Array.isArray(shots)) return [];\n  const seen = new Set<string>();\n  return shots\n    .filter((s) => s.kind === 'route' && s.route && s.tenant && (s.status === 'changed' || s.status === 'added'))\n    .sort((a, b) => b.percent - a.percent)\n    .filter((s) => {\n      const key = `${s.route}|${s.tenant}|${s.theme}`;\n      if (seen.has(key)) return false;\n      seen.add(key);\n      return true;\n    })\n    .map((s) => ({ label: s.label, route: s.route!, tenant: s.tenant!, theme: s.theme, percent: s.percent }));\n}\n\n/**\n * The same page on another deployment (code changes: production for Before, the preview for After), with the\n * change, the way back and the scroll position in the query. The hash route (ra-core) is kept.\n */\nexport function sameScreenOn(target: string, here: { search: string; hash: string }, extra: { change: number; returnTo?: string | null; scroll?: number }): string {\n  const url = new URL(target);\n  const params = new URLSearchParams(here.search);\n  params.delete(RETURN_PARAM);\n  params.delete(SCROLL_PARAM);\n  params.set(PARAM, String(extra.change));\n  if (extra.returnTo) params.set(RETURN_PARAM, extra.returnTo);\n  if (extra.scroll && extra.scroll > 0) params.set(SCROLL_PARAM, String(Math.round(extra.scroll)));\n  url.pathname = '/';\n  url.search = params.toString();\n  url.hash = here.hash;\n  return url.href;\n}\n\n/** The scroll position a Before/After navigation carried, once: the caller removes it from the address. */\nexport function readScroll(search: string): number | null {\n  const raw = new URLSearchParams(search).get(SCROLL_PARAM);\n  return raw && /^\\d{1,7}$/.test(raw) ? Number(raw) : null;\n}\n\nexport type Dock = 'start' | 'center' | 'end';\nconst DOCKS: Dock[] = ['start', 'center', 'end'];\n\n/** Bottom right by default: the corner a back office leaves free most often. */\nexport function readDock(storage: StorageLike | null): Dock {\n  const v = storage ? safe(() => storage.getItem(DOCK_KEY), null) : null;\n  return DOCKS.includes(v as Dock) ? (v as Dock) : 'end';\n}\n\n/** One step left (-1) or right (+1), stopping at the edges. */\nexport function stepDock(dock: Dock, step: -1 | 1): Dock {\n  return DOCKS[Math.min(DOCKS.length - 1, Math.max(0, DOCKS.indexOf(dock) + step))]!;\n}\n\n/** The dock nearest to where a drag ended: thirds of the viewport width. */\nexport function dockAt(x: number, width: number): Dock {\n  if (width <= 0) return 'center';\n  const r = x / width;\n  return r < 1 / 3 ? 'start' : r > 2 / 3 ? 'end' : 'center';\n}\n\n/** Title of a change as people read it: conventional prefixes (\"tokens: \") dropped, first letter up. */\nexport function readableTitle(title: string): string {\n  const t = title.replace(/^\\s*[a-z]+(\\([^)]*\\))?!?:\\s*/i, '').trim() || title.trim();\n  return t.charAt(0).toUpperCase() + t.slice(1);\n}\n\n/** The B shortcut flips Before and After, unless the person is typing or holds a modifier. */\nexport function isFlipKey(e: { key: string; altKey: boolean; ctrlKey: boolean; metaKey: boolean; target: unknown }): boolean {\n  if (e.altKey || e.ctrlKey || e.metaKey || e.key.toLowerCase() !== 'b') return false;\n  const t = e.target as { tagName?: string; isContentEditable?: boolean; closest?: (s: string) => unknown } | null;\n  if (!t) return true;\n  if (t.isContentEditable) return false;\n  const tag = (t.tagName ?? '').toLowerCase();\n  if (tag === 'input' || tag === 'textarea' || tag === 'select') return false;\n  return !(t.closest && t.closest('[role=\"combobox\"], [role=\"textbox\"], [role=\"searchbox\"]'));\n}\n\nexport interface Rect {\n  left: number;\n  top: number;\n  right: number;\n  bottom: number;\n}\n\nconst overlaps = (a: Rect, b: Rect, margin: number) => a.left < b.right + margin && a.right > b.left - margin && a.top < b.bottom + margin && a.bottom > b.top - margin;\n\n/**\n * Where the toolbar goes so it never covers a primary or submit button of the page: the chosen dock if it is free,\n * else the opposite corner, else the centre, else the chosen dock lifted just above the buttons it would cover. The\n * docks sit inside the area [left, right] (the content column, so it never sits over the sidebar).\n */\nexport function placeToolbar(input: { left: number; right: number; vh: number; w: number; h: number; gutter: number; preferred: Dock; obstacles: Rect[]; margin?: number }): { dock: Dock; lift: number } {\n  const { left: areaLeft, right: areaRight, vh, w, h, gutter, preferred, obstacles } = input;\n  const margin = input.margin ?? 8;\n  const rectAt = (dock: Dock, lift = 0): Rect => {\n    const left = dock === 'start' ? areaLeft : dock === 'end' ? areaRight - w : (areaLeft + areaRight - w) / 2;\n    const bottom = vh - gutter - lift;\n    return { left, right: left + w, top: bottom - h, bottom };\n  };\n  const opposite: Dock = preferred === 'start' ? 'end' : 'start';\n  const order: Dock[] = [preferred, opposite, ...DOCKS.filter((d) => d !== preferred && d !== opposite)];\n  for (const dock of order) {\n    const r = rectAt(dock);\n    if (!obstacles.some((o) => overlaps(r, o, margin))) return { dock, lift: 0 };\n  }\n  // Every dock covers something: stay put and rise above the highest button in the way.\n  const base = rectAt(preferred);\n  const inWay = obstacles.filter((o) => o.left < base.right + margin && o.right > base.left - margin && o.bottom > base.top - margin);\n  const top = Math.min(...inWay.map((o) => o.top));\n  const lift = Math.max(0, Math.ceil(base.bottom - (top - margin)));\n  return { dock: preferred, lift: Math.min(lift, Math.max(0, vh - h - 2 * gutter)) };\n}\n\n/** What one token file can change on screen: a theme and a brand, or every one of them (null). */\nfunction fileScope(file: string): { theme: string | null; brand: string | null } | 'none' {\n  if (file.startsWith('.changeset/')) return 'none';\n  let m = /(?:^|\\/)semantic\\/([a-z0-9-]+)\\.tokens\\.json$/i.exec(file);\n  if (m && m[1] !== 'base') return { theme: m[1]!, brand: null };\n  m = /(?:^|\\/)brands\\/([a-z0-9-]+)\\.([a-z0-9-]+)\\.tokens\\.json$/i.exec(file);\n  if (m) return { theme: m[2]!, brand: m[1]! };\n  m = /(?:^|\\/)brands\\/([a-z0-9-]+)\\.tokens\\.json$/i.exec(file);\n  if (m) return { theme: null, brand: m[1]! };\n  // Primitives, base, density, components and anything else: could change every theme and brand.\n  return { theme: null, brand: null };\n}\n\nexport type NoDifference = { kind: 'theme'; here: string; touched: string } | { kind: 'brand'; here: string; touched: string };\n\n/**\n * Whether a token change shows nothing in this theme and brand, from the token files it edits (DTCG layers named\n * semantic/<theme>, brands/<brand>.<theme>, brands/<brand>). Null when it may show, or when that cannot be told:\n * never claims \"no difference\" on a guess.\n */\nexport function noVisibleDifference(files: string[], here: { theme: string; brand: string }): NoDifference | null {\n  const scopes = files.map(fileScope).filter((s): s is { theme: string | null; brand: string | null } => s !== 'none');\n  if (!scopes.length) return null;\n  const hits = (theme: string, brand: string) => scopes.some((s) => (s.theme === null || s.theme === theme) && (s.brand === null || s.brand === brand));\n  if (hits(here.theme, here.brand)) return null;\n  const theme = scopes.find((s) => s.theme !== null && s.theme !== here.theme && (s.brand === null || s.brand === here.brand))?.theme;\n  if (theme) return { kind: 'theme', here: here.theme, touched: theme };\n  const brand = scopes.find((s) => s.brand !== null && s.brand !== here.brand)?.brand;\n  return brand ? { kind: 'brand', here: here.brand, touched: brand } : null;\n}\n\n/** \"darker default background.\" The change title as a short phrase after \"This change:\". */\nexport function changeSummary(title: string): string {\n  const t = readableTitle(title).replace(/[.\\s]+$/, '');\n  if (!t) return '';\n  const lower = /^[A-Z][a-z]/.test(t) ? t.charAt(0).toLowerCase() + t.slice(1) : t;\n  return `${lower}.`;\n}\n\nexport interface TokenChange {\n  /** Token path, \"color.bg.default\". */\n  path: string;\n  /** CSS variable the token builds to, \"--color-bg-default\". */\n  cssVar: string;\n  /** The role it plays, what designers call it: \"Page canvas\" (its description), \"Brand primary\" (a palette role). */\n  name: string;\n  /** The exact step, second: \"Primary 700\" for a palette step, null for a semantic token. */\n  step: string | null;\n  type: string | null;\n  /** The theme and brand its file applies to (null: every one). */\n  theme: string | null;\n  brand: string | null;\n}\n\ntype TokenNode = { $value?: unknown; $type?: string; $description?: string; [k: string]: unknown };\ntype Leaf = { value: string; type: string | null; description: string | null };\n\nfunction leaves(node: unknown, path: string[] = [], inheritedType: string | null = null, out = new Map<string, Leaf>()): Map<string, Leaf> {\n  if (!node || typeof node !== 'object') return out;\n  const n = node as TokenNode;\n  const type = typeof n.$type === 'string' ? n.$type : inheritedType;\n  if ('$value' in n) {\n    out.set(path.join('.'), { value: JSON.stringify(n.$value), type, description: typeof n.$description === 'string' ? n.$description : null });\n    return out;\n  }\n  for (const [k, v] of Object.entries(n)) if (!k.startsWith('$')) leaves(v, [...path, k], type, out);\n  return out;\n}\n\n/** Palette roles a brand re-points (brands/<brand>.tokens.json), in designers' words. */\nconst PALETTE_ROLES: Record<string, string> = { primary: 'Brand primary', link: 'Link', neutral: 'Neutral', accent: 'Accent', success: 'Success', warning: 'Warning', danger: 'Danger', info: 'Info', categorical: 'Chart colours' };\n\n/** The role a token plays: its description's first phrase, a palette role (\"Brand primary\"), else its path in words. */\nexport function roleOfToken(path: string, description: string | null): string {\n  const first = description?.split(/[.:;(]/)[0]?.trim();\n  if (first && first.length <= 40) return first;\n  const m = /^palette\\.([a-z-]+)\\./.exec(path);\n  if (m) return PALETTE_ROLES[m[1]!] ?? designerName(`palette.${m[1]}`, null);\n  return designerName(path, null);\n}\n\n/** The palette step, shown second: \"palette.primary.700\" -> \"Primary 700\"; null for other tokens. */\nexport function stepOfToken(path: string): string | null {\n  return path.startsWith('palette.') ? designerName(path, null) : null;\n}\n\n/** Designer name of a token: the first phrase of its description, else its path in words (\"Bg default\"). */\nexport function designerName(path: string, description: string | null): string {\n  const first = description?.split(/[.:;(]/)[0]?.trim();\n  if (first && first.length <= 40) return first;\n  const words = path.replace(/^(color|palette)\\./, '').split('.').join(' ');\n  return words.charAt(0).toUpperCase() + words.slice(1);\n}\n\n/**\n * The tokens one file changes between two versions of it (parsed DTCG JSON, null when the file is added or removed):\n * every leaf whose $value differs, with the theme and brand its layer applies to.\n */\nexport function tokenChanges(file: string, before: unknown, after: unknown): TokenChange[] {\n  const scope = fileScope(file);\n  if (scope === 'none') return [];\n  const a = leaves(before);\n  const b = leaves(after);\n  const out: TokenChange[] = [];\n  for (const path of new Set([...a.keys(), ...b.keys()])) {\n    const x = a.get(path);\n    const y = b.get(path);\n    if (x?.value === y?.value) continue;\n    out.push({\n      path,\n      cssVar: `--${path.split('.').join('-')}`,\n      name: roleOfToken(path, y?.description ?? x?.description ?? null),\n      step: stepOfToken(path),\n      type: y?.type ?? x?.type ?? null,\n      theme: scope.theme,\n      brand: scope.brand,\n    });\n  }\n  return out;\n}\n\n/** WCAG contrast ratio between two rgb() colours, or null when either is not rgb (a non-colour value). */\nexport function contrastRatio(a: string, b: string): number | null {\n  const lum = (c: string) => {\n    const m = /^rgba?\\((\\d+),\\s*(\\d+),\\s*(\\d+)/.exec(c.trim());\n    if (!m) return null;\n    const [r, g, bl] = [m[1], m[2], m[3]].map((n) => {\n      const v = Number(n) / 255;\n      return v <= 0.03928 ? v / 12.92 : ((v + 0.055) / 1.055) ** 2.4;\n    }) as [number, number, number];\n    return 0.2126 * r + 0.7152 * g + 0.0722 * bl;\n  };\n  const x = lum(a);\n  const y = lum(b);\n  if (x === null || y === null) return null;\n  return (Math.max(x, y) + 0.05) / (Math.min(x, y) + 0.05);\n}\n\n/** Two colours under 1.1:1 read as the same at a glance: the swatch says \"Subtle change\" so it does not look broken. */\nexport const isSubtle = (a: string, b: string): boolean => {\n  const r = contrastRatio(a, b);\n  return r !== null && r < 1.1;\n};\n\n/** rgb(245, 247, 249) -> #f5f7f9; anything else as is. */\nexport function toHex(color: string): string {\n  const m = /^rgba?\\((\\d+),\\s*(\\d+),\\s*(\\d+)(?:,\\s*([\\d.]+))?\\)$/.exec(color.trim());\n  if (!m) return color;\n  const hex = [m[1], m[2], m[3]].map((n) => Number(n).toString(16).padStart(2, '0')).join('');\n  return m[4] !== undefined && Number(m[4]) < 1 ? `#${hex}${Math.round(Number(m[4]) * 255).toString(16).padStart(2, '0')}` : `#${hex}`;\n}\n\n/** \"from Darker default background\", \"from #101 and #118\": which change a token's value comes from (changes tried together). */\nexport function fromText(from: number[], titleOf: (n: number) => string | null): string {\n  const names = from.map((n) => titleOf(n) ?? `#${n}`);\n  return `from ${names.length <= 2 ? names.join(' and ') : `${names.slice(0, -1).join(', ')} and ${names[names.length - 1]}`}`;\n}\n"],"names":["lift","theme","brand"],"mappings":"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"}

package/dist/session.d.ts

@@ -25,6 +25,8 @@ export interface BridgeBuild {
     /** The product's key (products[].key) and the design system repository ("owner/name"), for the way back to Studio. */
     product?: string;
     ds?: string;
+    /** Bridge's origin for GitHub reads (its read proxy); default production Bridge, null to read GitHub directly. */
+    proxy?: string | null;
 }
 export declare const PARAM = "bridge";
 /** Where After lives for a code change, carried to production on Before. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bridge-ds/toolbar",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "type": "module",
   "description": "The Bridge toolbar for a product built with the Bridge design system: opened from Bridge Studio with ?bridge=<change>, it flips the real product between before and after and shows what changed.",
   "license": "MIT",
@@ -49,7 +49,7 @@
     "build:package": "node ../../scripts/build-packages.mjs toolbar"
   },
   "dependencies": {
-    "@bridge-ds/core": "^0.22.0",
+    "@bridge-ds/core": "^0.23.0",
     "lucide-react": "1.58.0"
   },
   "peerDependencies": {