@bridge-ds/toolbar 0.0.0-stage → 0.2.0

package/dist/index-3f0I3tAL.js

@@ -0,0 +1,145 @@
+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-CzR1TM9x.js"));
+function asked() {
+  let store = null;
+  try {
+    store = window.sessionStorage;
+  } catch {
+    store = null;
+  }
+  return readChanges(window.location.search, store).length > 0;
+}
+function BridgeToolbar(props) {
+  const [on] = useState(() => typeof window !== "undefined" && asked());
+  if (!on) return null;
+  return /* @__PURE__ */ jsx(Suspense, { fallback: null, children: /* @__PURE__ */ jsx(Toolbar, { ...props }) });
+}
+const read = () => {
+  const el = document.documentElement;
+  return {
+    theme: el.getAttribute("data-theme") === "dark" ? "dark" : "light",
+    brand: el.getAttribute("data-brand") || "bridge",
+    density: el.getAttribute("data-density") || "comfortable"
+  };
+};
+function useDocumentScope() {
+  const [here, setHere] = useState(read);
+  useEffect(() => {
+    const mo = new MutationObserver(() => setHere((p) => {
+      const n = read();
+      return n.theme === p.theme && n.brand === p.brand && n.density === p.density ? p : n;
+    }));
+    mo.observe(document.documentElement, { attributes: true, attributeFilter: ["data-theme", "data-brand", "data-density"] });
+    return () => mo.disconnect();
+  }, []);
+  return useMemo(
+    () => ({
+      ...here,
+      set: (next) => {
+        if (next.theme) document.documentElement.setAttribute("data-theme", next.theme);
+      }
+    }),
+    [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;
+  const config = raw;
+  const entry = (config.products ?? []).find((p) => p?.key === product);
+  if (!entry) return null;
+  const own = entry.repo && REPO.test(entry.repo) ? entry.repo : null;
+  const [owner, repo] = (own ?? ds).split("/");
+  const pick = (v, fallback) => v !== void 0 ? v : fallback ?? null;
+  return {
+    owner,
+    repo,
+    studio: pick(overrides.studio, config.previews?.production?.docs),
+    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,
+    ds
+  };
+}
+const cacheKey = (ds) => `bridge-toolbar:config:v1:${ds}`;
+async function loadBuild(ds, product, overrides = {}, gh) {
+  let config = null;
+  try {
+    const cached = window.sessionStorage.getItem(cacheKey(ds));
+    if (cached) config = JSON.parse(cached);
+  } catch {
+  }
+  if (!config) {
+    if (!REPO.test(ds)) throw new Error(`"${ds}" is not a GitHub repository (owner/name).`);
+    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 {
+    }
+  }
+  const build = buildFromConfig(config, ds, product, overrides);
+  if (!build) throw new Error(`No product "${product}" in ${ds}'s bridge.config.json.`);
+  return build;
+}
+export {
+  BridgeToolbar as B,
+  DEFAULT_PROXY as D,
+  buildFromConfig as b,
+  githubReads as g,
+  loadBuild as l,
+  useDocumentScope as u
+};
+//# 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

@@ -0,0 +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

@@ -0,0 +1,8 @@
+import { B, D, b, u } from "./index-3f0I3tAL.js";
+export {
+  B as BridgeToolbar,
+  D as DEFAULT_PROXY,
+  b as buildFromConfig,
+  u as useDocumentScope
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/outline.d.ts

@@ -0,0 +1,41 @@
+import { type RuleLike } from './diff';
+export interface PropChange {
+    prop: string;
+    /** Computed value with the live tokens. */
+    before: string;
+    /** Computed value with the change's tokens. */
+    after: string;
+}
+export interface ChangedElement {
+    el: Element;
+    pseudo: string | null;
+    /** CSS variables of the changed tokens behind the difference. */
+    roots: string[];
+    props: PropChange[];
+    /** What a person calls it: "Page", "Save bar (Save changes)". */
+    label: string;
+    /** "root|property" pairs: an ancestor with all of them paints the same change. */
+    keys: string[];
+    /** Sticky or fixed: paints over other content, so it is a surface even inside a changed ancestor. */
+    floating: boolean;
+}
+export interface DiffResult {
+    /** Every element whose computed style differs. */
+    elements: ChangedElement[];
+    /** The outermost of them: what is outlined and counted (when visible). */
+    surfaces: ChangedElement[];
+    /** Time the comparison took, in ms (rules are read once per page load and cached). */
+    ms: number;
+}
+/** The page's own style rules (same origin), without the live tokens stylesheet the toolbar adds. Cached. */
+export declare function pageRules(): RuleLike[];
+/** "Page", "Content column", "Save bar (Save changes)": landmark, ARIA role or component first, its text after. */
+export declare function describe(el: Element): string;
+/** The part of an element inside the viewport, or null when none of it shows (hidden, transparent, off screen). */
+export declare function shownRect(el: Element): DOMRect | null;
+/**
+ * Compares the candidates under both token sets. `sheet` is the toolbar's stylesheet that switches sides (loaded):
+ * the live tokens over a change's preview (`sheetIs` 'before', one change), or the combination over the live product
+ * (`sheetIs` 'after', changes tried together). `ignore` holds the toolbar's own nodes.
+ */
+export declare function changedElements(changedVars: string[], sheet: HTMLLinkElement | HTMLStyleElement, ignore: (el: Element) => boolean, sheetIs?: 'before' | 'after'): DiffResult;

package/dist/pin.d.ts

@@ -0,0 +1,6 @@
+/** Marks an element (and what is inside it) as pinned: the toolbar root, the outline layer, their popups. */
+export declare const PIN_ATTR = "data-bridge-pin";
+/** Same, as a class, for popups the DS portals out (Tooltip and Popover accept a className, not attributes). */
+export declare const PIN_CLASS = "bridge-pin";
+/** Writes the pinned tokens for the current theme. Three-fold selectors out-rank the tokens' attribute rules. */
+export declare function usePinnedBridgeTokens(url: string | null, theme: string): void;

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

@@ -0,0 +1,20 @@
+export interface ToolbarScope {
+    theme: 'light' | 'dark';
+    brand: string;
+    density: string;
+    /** The shop (tenant) the page shows, when the product has several. */
+    shop?: string;
+    /** Moves the page to a theme, a shop or both, in one step. */
+    set: (next: {
+        theme?: 'light' | 'dark';
+        shop?: string;
+    }) => void;
+}
+/** A shop of a multi-brand product: its id (in `?tenant=` links), its name and its brand. */
+export interface ToolbarShop {
+    id: string;
+    name: string;
+    brand: string;
+}
+/** The default scope: <html data-theme data-brand data-density>, kept in sync. */
+export declare function useDocumentScope(): ToolbarScope;

package/dist/session-CzlIsFDY.js

@@ -0,0 +1,325 @@
+const PARAM = "bridge";
+const RETURN_PARAM = "bridge-return";
+const SCROLL_PARAM = "bridge-scroll";
+const SESSION_KEY = "bridge-admin:change";
+const RETURN_KEY = "bridge-admin:return";
+const DOCK_KEY = "bridge-admin:toolbar-dock";
+const OPEN_KEY = "bridge-admin:toolbar-open";
+const USE_PARAM = "bridge-use";
+const USE_KEY = "bridge-admin:use";
+const MAX_TOGETHER = 4;
+const safe = (fn, fallback) => {
+  try {
+    return fn();
+  } catch {
+    return fallback;
+  }
+};
+function parseChanges(raw) {
+  const parts = (raw ?? "").trim().split(/,|%2C/i).map((p) => p.trim());
+  if (!parts.every((p) => /^\d{1,7}$/.test(p) && Number(p) > 0)) return [];
+  return [...new Set(parts.map(Number))].slice(0, MAX_TOGETHER);
+}
+function readChanges(search, storage) {
+  const params = new URLSearchParams(search);
+  if (params.has(PARAM)) {
+    const list = parseChanges(params.get(PARAM));
+    if (!list.length) {
+      if (storage) safe(() => (storage.removeItem(SESSION_KEY), storage.removeItem(USE_KEY)), void 0);
+      return [];
+    }
+    if (storage) {
+      safe(() => storage.setItem(SESSION_KEY, list.join(",")), void 0);
+      const use = params.get(USE_PARAM);
+      safe(() => use && list.length > 1 ? storage.setItem(USE_KEY, use) : storage.removeItem(USE_KEY), void 0);
+    }
+    return list;
+  }
+  return storage ? parseChanges(safe(() => storage.getItem(SESSION_KEY), null)) : [];
+}
+function readUse(search, storage) {
+  const params = new URLSearchParams(search);
+  if (params.has(PARAM)) return params.get(USE_PARAM);
+  return storage ? safe(() => storage.getItem(USE_KEY), null) : null;
+}
+function isPreviewUrl(raw, template) {
+  if (!raw || !template) return false;
+  let url;
+  let tpl;
+  try {
+    url = new URL(raw);
+    tpl = new URL(template.replace(/\{[a-z]+\}/gi, "x"));
+  } catch {
+    return false;
+  }
+  if (url.protocol !== "https:" || url.username || url.password || url.port) return false;
+  const tplHost = /^https?:\/\/([^/?#]+)/i.exec(template)?.[1]?.toLowerCase();
+  if (!tplHost || tpl.protocol !== "https:") return false;
+  const pattern = new RegExp(`^${tplHost.split(/\{[a-z]+\}/i).map((p) => p.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")).join("[a-z0-9-]+")}$`);
+  return pattern.test(url.hostname.toLowerCase());
+}
+function readReturn(search, storage, template) {
+  const raw = new URLSearchParams(search).get(RETURN_PARAM);
+  if (raw !== null) {
+    if (isPreviewUrl(raw, template)) {
+      const origin = new URL(raw).origin;
+      if (storage) safe(() => storage.setItem(RETURN_KEY, origin), void 0);
+      return origin;
+    }
+    return null;
+  }
+  const stored = storage ? safe(() => storage.getItem(RETURN_KEY), null) : null;
+  return isPreviewUrl(stored, template) ? new URL(stored).origin : null;
+}
+function whereAmI(host, build) {
+  const prodHost = build.production ? safe(() => new URL(build.production).host, null) : null;
+  if (build.deployEnv === "production" || prodHost && host.toLowerCase() === prodHost.toLowerCase()) return "production";
+  if (build.deployEnv === "preview") return "preview";
+  return "local";
+}
+function shouldRender(input) {
+  if (input.change === null) return false;
+  if (input.together) return true;
+  if (input.where === "production") return input.returnTo !== null;
+  return true;
+}
+const togetherLabel = (n) => n === 1 ? "This change" : `These ${n} changes`;
+const TOGETHER_HINT = "The live product, with these changes' tokens applied in your browser only. No preview has all of them together.";
+const TOGETHER_EMPTY_LINE = "These changes don't touch this screen. Try another screen.";
+function toggleIncluded(all, included, n, on) {
+  const next = new Set(included);
+  if (on) next.add(n);
+  else next.delete(n);
+  return all.filter((x) => next.has(x));
+}
+function studioChangesUrl(build) {
+  return build.studio ? `${build.studio.replace(/\/$/, "")}/studio/changes/` : `https://github.com/${build.owner}/${build.repo}/pulls`;
+}
+function changeMode(files) {
+  const tokenOnly = files.length > 0 && files.every((f) => f.endsWith(".tokens.json") || /contrast\.checks\.json$/.test(f) || f.startsWith(".changeset/"));
+  return tokenOnly ? "tokens" : "code";
+}
+function liveTokensUrl(build) {
+  return build.studio ? safe(() => new URL("tokens.css", build.studio.replace(/\/?$/, "/")).href, null) : null;
+}
+function studioChangeUrl(build, change) {
+  if (!build.studio) return `https://github.com/${build.owner}/${build.repo}/pull/${change}`;
+  const studio = build.studio.replace(/\/$/, "");
+  const own = build.product && build.ds && build.ds.toLowerCase() !== `${build.owner}/${build.repo}`.toLowerCase();
+  return own ? `${studio}/studio/changes/?exploration=${change}&product=${encodeURIComponent(build.product)}` : `${studio}/studio/changes/?pr=${change}`;
+}
+function changedScreens(shots) {
+  if (!Array.isArray(shots)) return [];
+  const seen = /* @__PURE__ */ new Set();
+  return shots.filter((s) => s.kind === "route" && s.route && s.tenant && (s.status === "changed" || s.status === "added")).sort((a, b) => b.percent - a.percent).filter((s) => {
+    const key = `${s.route}|${s.tenant}|${s.theme}`;
+    if (seen.has(key)) return false;
+    seen.add(key);
+    return true;
+  }).map((s) => ({ label: s.label, route: s.route, tenant: s.tenant, theme: s.theme, percent: s.percent }));
+}
+function sameScreenOn(target, here, extra) {
+  const url = new URL(target);
+  const params = new URLSearchParams(here.search);
+  params.delete(RETURN_PARAM);
+  params.delete(SCROLL_PARAM);
+  params.set(PARAM, String(extra.change));
+  if (extra.returnTo) params.set(RETURN_PARAM, extra.returnTo);
+  if (extra.scroll && extra.scroll > 0) params.set(SCROLL_PARAM, String(Math.round(extra.scroll)));
+  url.pathname = "/";
+  url.search = params.toString();
+  url.hash = here.hash;
+  return url.href;
+}
+function readScroll(search) {
+  const raw = new URLSearchParams(search).get(SCROLL_PARAM);
+  return raw && /^\d{1,7}$/.test(raw) ? Number(raw) : null;
+}
+const DOCKS = ["start", "center", "end"];
+function readDock(storage) {
+  const v = storage ? safe(() => storage.getItem(DOCK_KEY), null) : null;
+  return DOCKS.includes(v) ? v : "end";
+}
+function stepDock(dock, step) {
+  return DOCKS[Math.min(DOCKS.length - 1, Math.max(0, DOCKS.indexOf(dock) + step))];
+}
+function dockAt(x, width) {
+  if (width <= 0) return "center";
+  const r = x / width;
+  return r < 1 / 3 ? "start" : r > 2 / 3 ? "end" : "center";
+}
+function readableTitle(title) {
+  const t = title.replace(/^\s*[a-z]+(\([^)]*\))?!?:\s*/i, "").trim() || title.trim();
+  return t.charAt(0).toUpperCase() + t.slice(1);
+}
+function isFlipKey(e) {
+  if (e.altKey || e.ctrlKey || e.metaKey || e.key.toLowerCase() !== "b") return false;
+  const t = e.target;
+  if (!t) return true;
+  if (t.isContentEditable) return false;
+  const tag = (t.tagName ?? "").toLowerCase();
+  if (tag === "input" || tag === "textarea" || tag === "select") return false;
+  return !(t.closest && t.closest('[role="combobox"], [role="textbox"], [role="searchbox"]'));
+}
+const overlaps = (a, b, margin) => a.left < b.right + margin && a.right > b.left - margin && a.top < b.bottom + margin && a.bottom > b.top - margin;
+function placeToolbar(input) {
+  const { left: areaLeft, right: areaRight, vh, w, h, gutter, preferred, obstacles } = input;
+  const margin = input.margin ?? 8;
+  const rectAt = (dock, lift2 = 0) => {
+    const left = dock === "start" ? areaLeft : dock === "end" ? areaRight - w : (areaLeft + areaRight - w) / 2;
+    const bottom = vh - gutter - lift2;
+    return { left, right: left + w, top: bottom - h, bottom };
+  };
+  const opposite = preferred === "start" ? "end" : "start";
+  const order = [preferred, opposite, ...DOCKS.filter((d) => d !== preferred && d !== opposite)];
+  for (const dock of order) {
+    const r = rectAt(dock);
+    if (!obstacles.some((o) => overlaps(r, o, margin))) return { dock, lift: 0 };
+  }
+  const base = rectAt(preferred);
+  const inWay = obstacles.filter((o) => o.left < base.right + margin && o.right > base.left - margin && o.bottom > base.top - margin);
+  const top = Math.min(...inWay.map((o) => o.top));
+  const lift = Math.max(0, Math.ceil(base.bottom - (top - margin)));
+  return { dock: preferred, lift: Math.min(lift, Math.max(0, vh - h - 2 * gutter)) };
+}
+function fileScope(file) {
+  if (file.startsWith(".changeset/")) return "none";
+  let m = /(?:^|\/)semantic\/([a-z0-9-]+)\.tokens\.json$/i.exec(file);
+  if (m && m[1] !== "base") return { theme: m[1], brand: null };
+  m = /(?:^|\/)brands\/([a-z0-9-]+)\.([a-z0-9-]+)\.tokens\.json$/i.exec(file);
+  if (m) return { theme: m[2], brand: m[1] };
+  m = /(?:^|\/)brands\/([a-z0-9-]+)\.tokens\.json$/i.exec(file);
+  if (m) return { theme: null, brand: m[1] };
+  return { theme: null, brand: null };
+}
+function noVisibleDifference(files, here) {
+  const scopes = files.map(fileScope).filter((s) => s !== "none");
+  if (!scopes.length) return null;
+  const hits = (theme2, brand2) => scopes.some((s) => (s.theme === null || s.theme === theme2) && (s.brand === null || s.brand === brand2));
+  if (hits(here.theme, here.brand)) return null;
+  const theme = scopes.find((s) => s.theme !== null && s.theme !== here.theme && (s.brand === null || s.brand === here.brand))?.theme;
+  if (theme) return { kind: "theme", here: here.theme, touched: theme };
+  const brand = scopes.find((s) => s.brand !== null && s.brand !== here.brand)?.brand;
+  return brand ? { kind: "brand", here: here.brand, touched: brand } : null;
+}
+function changeSummary(title) {
+  const t = readableTitle(title).replace(/[.\s]+$/, "");
+  if (!t) return "";
+  const lower = /^[A-Z][a-z]/.test(t) ? t.charAt(0).toLowerCase() + t.slice(1) : t;
+  return `${lower}.`;
+}
+function leaves(node, path = [], inheritedType = null, out = /* @__PURE__ */ new Map()) {
+  if (!node || typeof node !== "object") return out;
+  const n = node;
+  const type = typeof n.$type === "string" ? n.$type : inheritedType;
+  if ("$value" in n) {
+    out.set(path.join("."), { value: JSON.stringify(n.$value), type, description: typeof n.$description === "string" ? n.$description : null });
+    return out;
+  }
+  for (const [k, v] of Object.entries(n)) if (!k.startsWith("$")) leaves(v, [...path, k], type, out);
+  return out;
+}
+const PALETTE_ROLES = { primary: "Brand primary", link: "Link", neutral: "Neutral", accent: "Accent", success: "Success", warning: "Warning", danger: "Danger", info: "Info", categorical: "Chart colours" };
+function roleOfToken(path, description) {
+  const first = description?.split(/[.:;(]/)[0]?.trim();
+  if (first && first.length <= 40) return first;
+  const m = /^palette\.([a-z-]+)\./.exec(path);
+  if (m) return PALETTE_ROLES[m[1]] ?? designerName(`palette.${m[1]}`);
+  return designerName(path);
+}
+function stepOfToken(path) {
+  return path.startsWith("palette.") ? designerName(path) : null;
+}
+function designerName(path, description) {
+  const words = path.replace(/^(color|palette)\./, "").split(".").join(" ");
+  return words.charAt(0).toUpperCase() + words.slice(1);
+}
+function tokenChanges(file, before, after) {
+  const scope = fileScope(file);
+  if (scope === "none") return [];
+  const a = leaves(before);
+  const b = leaves(after);
+  const out = [];
+  for (const path of /* @__PURE__ */ new Set([...a.keys(), ...b.keys()])) {
+    const x = a.get(path);
+    const y = b.get(path);
+    if (x?.value === y?.value) continue;
+    out.push({
+      path,
+      cssVar: `--${path.split(".").join("-")}`,
+      name: roleOfToken(path, y?.description ?? x?.description ?? null),
+      step: stepOfToken(path),
+      type: y?.type ?? x?.type ?? null,
+      theme: scope.theme,
+      brand: scope.brand
+    });
+  }
+  return out;
+}
+function contrastRatio(a, b) {
+  const lum = (c) => {
+    const m = /^rgba?\((\d+),\s*(\d+),\s*(\d+)/.exec(c.trim());
+    if (!m) return null;
+    const [r, g, bl] = [m[1], m[2], m[3]].map((n) => {
+      const v = Number(n) / 255;
+      return v <= 0.03928 ? v / 12.92 : ((v + 0.055) / 1.055) ** 2.4;
+    });
+    return 0.2126 * r + 0.7152 * g + 0.0722 * bl;
+  };
+  const x = lum(a);
+  const y = lum(b);
+  if (x === null || y === null) return null;
+  return (Math.max(x, y) + 0.05) / (Math.min(x, y) + 0.05);
+}
+const isSubtle = (a, b) => {
+  const r = contrastRatio(a, b);
+  return r !== null && r < 1.1;
+};
+function toHex(color) {
+  const m = /^rgba?\((\d+),\s*(\d+),\s*(\d+)(?:,\s*([\d.]+))?\)$/.exec(color.trim());
+  if (!m) return color;
+  const hex = [m[1], m[2], m[3]].map((n) => Number(n).toString(16).padStart(2, "0")).join("");
+  return m[4] !== void 0 && Number(m[4]) < 1 ? `#${hex}${Math.round(Number(m[4]) * 255).toString(16).padStart(2, "0")}` : `#${hex}`;
+}
+function fromText(from, titleOf) {
+  const names = from.map((n) => titleOf(n) ?? `#${n}`);
+  return `from ${names.length <= 2 ? names.join(" and ") : `${names.slice(0, -1).join(", ")} and ${names[names.length - 1]}`}`;
+}
+export {
+  togetherLabel as A,
+  changeSummary as B,
+  dockAt as C,
+  stepDock as D,
+  DOCK_KEY as E,
+  OPEN_KEY as O,
+  PARAM as P,
+  SCROLL_PARAM as S,
+  TOGETHER_EMPTY_LINE as T,
+  roleOfToken as a,
+  changeMode as b,
+  changedScreens as c,
+  readableTitle as d,
+  toggleIncluded as e,
+  readReturn as f,
+  readUse as g,
+  shouldRender as h,
+  readDock as i,
+  readScroll as j,
+  sameScreenOn as k,
+  liveTokensUrl as l,
+  studioChangesUrl as m,
+  noVisibleDifference as n,
+  studioChangeUrl as o,
+  contrastRatio as p,
+  TOGETHER_HINT as q,
+  readChanges as r,
+  stepOfToken as s,
+  tokenChanges as t,
+  isSubtle as u,
+  toHex as v,
+  whereAmI as w,
+  fromText as x,
+  isFlipKey as y,
+  placeToolbar as z
+};
+//# sourceMappingURL=session-CzlIsFDY.js.map