@bridge-ds/core 0.5.0 → 0.6.0

package/dist/audit/components.d.ts

@@ -8,5 +8,5 @@ export declare function classifyModule(mod: string, dsPackages: string[], extraF
 export declare function libraryLabel(mod: string, kind: ModuleKind): string;
 /** The DS component to use instead of a foreign one, when one fits. */
 export declare function dsEquivalent(name: string, ds: Set<string>): string | undefined;
-/** The DS component that replaces a native element. */
+/** The DS component that replaces a native element; undefined when the DS has none, and then the element is not a miss. */
 export declare function nativeEquivalent(tag: string, type: string | undefined, ds: Set<string>): string | undefined;

package/dist/audit/index.js

@@ -1,4 +1,4 @@
-import { A, a, b, C, D, c, F, I, L, d, M, N, e, f, g, h, i, j, k, l, m, n, o, p, q, r, s, t, u, v, w, x, y, z, B, E, G, H, J, K, O, P, Q, R, S, T, U, V, W, X, Y, Z } from "../report-4Z008HSf.js";
+import { A, a, b, C, D, c, F, I, L, d, M, N, e, f, g, h, i, j, k, l, m, n, o, p, q, r, s, t, u, v, w, x, y, z, B, E, G, H, J, K, O, P, Q, R, S, T, U, V, W, X, Y, Z } from "../report-iPSnsjYi.js";
 export {
   A as AUDIT_EXTENSIONS,
   a as AUDIT_IGNORE_DIRS,

package/dist/{component-spec-cvrSvIZj.js → component-spec-GFVEE6Fc.js}

@@ -544,7 +544,7 @@ function groupsPhrase(groups) {
 }
 function whoCanShipSentence(policy) {
   const names = (policy.entries ?? policy.logins).map((l) => entryLabel(l, policy.teams)).join(", ");
-  return `Only ${groupsPhrase(policy.groups)} can ship this${names ? ` (${names})` : ""}.`;
+  return `Only ${groupsPhrase(policy.groups)} can merge this${names ? ` (${names})` : ""}.`;
 }
 const DEFAULT_VISUAL_IMPACT = { mode: "auto" };
 const VISUAL_CHECK_LABEL = "visual-check";
@@ -2885,18 +2885,114 @@ const SPEC_FIELDS = [
   "paddingBottom",
   "paddingLeft",
   "itemSpacing",
+  "counterAxisSpacing",
   "width",
   "height",
   "minWidth",
   "minHeight",
+  "opacity",
   "textFill",
   "fontFamily",
   "fontSize",
   "fontWeight",
   "lineHeight",
-  "letterSpacing"
+  "letterSpacing",
+  "textDecoration"
 ];
 const COLOR_FIELDS = /* @__PURE__ */ new Set(["fill", "stroke", "textFill"]);
+function coverageSummary(file) {
+  const list2 = file.coverage ?? file.components.map((c) => ({ name: c.name, status: "generated" }));
+  const generated = list2.filter((c) => c.status === "generated").length;
+  const drafted = list2.filter((c) => c.status === "drafted").length;
+  const layout = list2.filter((c) => c.status === "layout").length;
+  return { generated, drafted, inFigma: generated + drafted, visual: list2.length - layout, layout, total: list2.length, missing: list2.filter((c) => c.status === "unsupported") };
+}
+const LAYOUT_DIRECTIONS = /* @__PURE__ */ new Set(["HORIZONTAL", "VERTICAL"]);
+const PRIMARY = /* @__PURE__ */ new Set(["MIN", "CENTER", "MAX", "SPACE_BETWEEN"]);
+const COUNTER = /* @__PURE__ */ new Set(["MIN", "CENTER", "MAX", "STRETCH"]);
+const PART_KINDS = /* @__PURE__ */ new Set(["frame", "text", "icon", "vector"]);
+function validateComponentSpec(spec, tokenTypes) {
+  const out = [];
+  const at = (where, why) => out.push(`${spec.name ?? "spec"}: ${where}: ${why}`);
+  if (typeof spec.name !== "string" || !spec.name) return ["the spec has no name"];
+  if (!Array.isArray(spec.axes) || !Array.isArray(spec.properties) || !Array.isArray(spec.parts) || !Array.isArray(spec.variants) || !Array.isArray(spec.unmapped)) return [`${spec.name}: axes, properties, parts, variants and unmapped must be lists`];
+  const axisNames = /* @__PURE__ */ new Set();
+  for (const a of spec.axes) {
+    if (!a.name || axisNames.has(a.name)) at("axes", `"${a.name}" is missing or repeated`);
+    axisNames.add(a.name);
+    if (!Array.isArray(a.values) || !a.values.length) at(`axis ${a.name}`, "has no values");
+    else if (!a.values.includes(a.default)) at(`axis ${a.name}`, `default "${a.default}" is not one of its values`);
+  }
+  const props = /* @__PURE__ */ new Map();
+  for (const p of spec.properties) {
+    if (props.has(p.name)) at("properties", `"${p.name}" is repeated`);
+    props.set(p.name, p);
+    if (p.type !== "TEXT" && p.type !== "BOOLEAN") at(`property ${p.name}`, `type ${String(p.type)} is not TEXT or BOOLEAN`);
+    else if (typeof p.default !== (p.type === "TEXT" ? "string" : "boolean")) at(`property ${p.name}`, `default must be a ${p.type === "TEXT" ? "text" : "true or false"}`);
+  }
+  const parts = /* @__PURE__ */ new Map();
+  for (const part of spec.parts) {
+    if (!part.id || parts.has(part.id)) at("parts", `id "${part.id}" is missing or repeated`);
+    if (!PART_KINDS.has(part.kind)) at(`part ${part.id}`, `kind ${String(part.kind)} is not frame, text, icon or vector`);
+    if (part.parent === void 0) {
+      if ([...parts.values()].some((x) => x.parent === void 0)) at(`part ${part.id}`, "a second root (every other part needs a parent)");
+    } else if (!parts.has(part.parent)) at(`part ${part.id}`, `parent "${part.parent}" is not a part listed before it`);
+    else if (parts.get(part.parent).kind !== "frame") at(`part ${part.id}`, `parent "${part.parent}" is not a frame`);
+    if (part.layout && (!LAYOUT_DIRECTIONS.has(part.layout.direction) || !PRIMARY.has(part.layout.primary) || !COUNTER.has(part.layout.counter))) at(`part ${part.id}`, "layout is not a valid auto layout");
+    if (part.text !== void 0 && props.get(part.text)?.type !== "TEXT") at(`part ${part.id}`, `text property "${part.text}" does not exist`);
+    if (part.visible !== void 0 && props.get(part.visible)?.type !== "BOOLEAN") at(`part ${part.id}`, `visibility property "${part.visible}" does not exist`);
+    if (part.kind === "text" && part.text === void 0 && part.characters === void 0 && !part.swap) at(`part ${part.id}`, "a text part needs a TEXT property or its characters");
+    parts.set(part.id, part);
+  }
+  if (!spec.parts.length || spec.parts[0].parent !== void 0) at("parts", "the first part must be the root");
+  const expected = spec.axes.reduce((n, a) => n * (a.values?.length || 1), 1);
+  if (spec.variants.length !== expected) at("variants", `${spec.variants.length} variants for ${expected} combinations of the axes`);
+  const seen = /* @__PURE__ */ new Set();
+  for (const v of spec.variants) {
+    const key = variantKeyOf(v.props ?? {});
+    const where = `variant ${key}`;
+    if (seen.has(key)) at(where, "is repeated");
+    seen.add(key);
+    for (const a of spec.axes) if (!a.values?.includes(v.props?.[a.name] ?? "")) at(where, `${a.name} is not one of its values`);
+    for (const k of Object.keys(v.props ?? {})) if (!axisNames.has(k)) at(where, `${k} is not an axis`);
+    for (const [id, fields] of Object.entries(v.values ?? {})) {
+      const part = parts.get(id);
+      if (!part) {
+        at(where, `values for "${id}", which is not a part`);
+        continue;
+      }
+      for (const [field, value] of Object.entries(fields ?? {})) {
+        if (!SPEC_FIELDS.includes(field)) at(`${where}, ${id}`, `${field} is not a field`);
+        else if (value === null) {
+          if (!COLOR_FIELDS.has(field)) at(`${where}, ${id}`, `${field} cannot be empty (only colors can be none)`);
+        } else if (typeof value === "number") {
+          if (COLOR_FIELDS.has(field)) at(`${where}, ${id}`, `${field} cannot be a number`);
+        } else if (typeof value !== "string") at(`${where}, ${id}`, `${field} must be a token path, a number or none`);
+        else if (field === "textDecoration") {
+          if (!/^(UNDERLINE|STRIKETHROUGH|NONE)$/.test(value)) at(`${where}, ${id}`, `${value} is not a text decoration`);
+        } else if (tokenTypes) {
+          for (const path of value.startsWith("calc(") ? (value.match(/[A-Za-z][\w.-]*/g) ?? []).filter((x) => x !== "calc" && !/^\d|^px$/.test(x)) : [value]) {
+            const type = tokenTypes.get(path);
+            if (!type) at(`${where}, ${id}`, `${path} is not a token`);
+            else if (!value.startsWith("calc(") && !FIELD_TOKEN_TYPES(field).includes(type)) at(`${where}, ${id}`, `${path} is a ${type} token, ${field} needs ${FIELD_TOKEN_TYPES(field).join(" or ")}`);
+          }
+        }
+      }
+    }
+    for (const id of v.hidden ?? []) if (!parts.has(id)) at(where, `hides "${id}", which is not a part`);
+    for (const id of Object.keys(v.layout ?? {})) if (!parts.has(id)) at(where, `lays out "${id}", which is not a part`);
+    for (const [id, vec] of Object.entries(v.vectors ?? {})) if (parts.get(id)?.kind !== "vector" || !/^<svg[\s>]/.test(vec.svg)) at(where, `vector "${id}" is not a vector part with an SVG`);
+    for (const id of Object.keys(v.slots ?? {})) if (!parts.has(id)) at(where, `shows a component in "${id}", which is not a part`);
+  }
+  return out;
+}
+function FIELD_TOKEN_TYPES(field) {
+  if (COLOR_FIELDS.has(field)) return ["color"];
+  if (field === "fontFamily") return ["fontFamily"];
+  if (field === "fontWeight") return ["fontWeight", "number"];
+  if (field === "opacity") return ["number"];
+  return ["dimension", "number"];
+}
 const iconComponentName = (name) => `Icon/${name}`;
 function specHash(text) {
   let h = 2166136261;
@@ -2907,7 +3003,7 @@ function specHash(text) {
   return (h >>> 0).toString(16).padStart(8, "0");
 }
 function hashSpec(spec) {
-  const { hash: _ignored, ...rest } = spec;
+  const { hash: _ignored, example: _example, ...rest } = spec;
   return specHash(JSON.stringify(rest));
 }
 const variantName = (props) => Object.entries(props).map(([k, v]) => `${k}=${v}`).join(", ");
@@ -2926,205 +3022,207 @@ function parseComponentSpecs(text) {
 }
 const tokenCssVar = (path, prefix = "--", separator = "-") => `${prefix}${path.split(".").join(separator)}`;
 export {
-  tokensPath as $,
-  flattenTokens as A,
-  serializeTokenFile as B,
-  COMPONENT_SPECS_VERSION as C,
-  removeToken as D,
-  upsertToken as E,
-  threeWayDiff as F,
-  emptyTokenFile as G,
-  parseTokenFile as H,
-  EXT_ID as I,
-  EXT_SCOPES as J,
-  resolve as K,
-  moveToken as L,
-  effectiveScopes as M,
-  sameScopes as N,
-  defaultScopes as O,
-  readTokenAt as P,
-  modeFile as Q,
-  defaultFile as R,
+  buildHistoryEntry as $,
+  contextLabel as A,
+  pathId as B,
+  CONFIG_FILE as C,
+  flattenTokens as D,
+  serializeTokenFile as E,
+  removeToken as F,
+  upsertToken as G,
+  threeWayDiff as H,
+  emptyTokenFile as I,
+  parseTokenFile as J,
+  EXT_ID as K,
+  EXT_SCOPES as L,
+  resolve as M,
+  moveToken as N,
+  effectiveScopes as O,
+  sameScopes as P,
+  defaultScopes as Q,
+  readTokenAt as R,
   SINGLE_MODE as S,
   TIER_NAMES as T,
-  DEFAULT_PROTECTED_BRANCHES as U,
-  ProtectedBranchError as V,
-  ConfigError as W,
-  DEFAULT_TOKEN_PATHS as X,
-  applyTokenEdits as Y,
-  buildHistoryEntry as Z,
-  resolveBranchPreviews as _,
+  modeFile as U,
+  defaultFile as V,
+  DEFAULT_PROTECTED_BRANCHES as W,
+  ProtectedBranchError as X,
+  ConfigError as Y,
+  DEFAULT_TOKEN_PATHS as Z,
+  applyTokenEdits as _,
   assertSafeBranch as a,
-  contextFor as a$,
-  coerceValue as a0,
-  toConfigJson as a1,
-  parseContrastChecks as a2,
-  checkLayeredPair as a3,
-  classifyRisk as a4,
-  formatChangeset as a5,
-  RISK_LABELS as a6,
-  parseJson as a7,
-  serializeJson as a8,
-  plainEqual as a9,
-  RISK_TIER as aA,
-  SPEC_FIELDS as aB,
-  TIER_ORDER as aC,
-  TeamDirectory as aD,
-  UNRELEASED as aE,
-  VISUAL_CHECK_LABEL as aF,
-  affectedContrast as aG,
-  appForProject as aH,
-  appUrl as aI,
-  approverEntries as aJ,
-  approverLists as aK,
-  assignVersions as aL,
-  baseBranchOf as aM,
-  branchName as aN,
-  branchSlug as aO,
-  canShip as aP,
-  changeKind as aQ,
-  changeTable as aR,
-  changedModes as aS,
-  changesetBump as aT,
-  classifyLayered as aU,
-  clearRawDeep as aV,
-  commitMessage as aW,
-  composeChangeset as aX,
-  composePrBody as aY,
-  composeProposalBody as aZ,
-  composite as a_,
-  toPlain as aa,
-  getEntry as ab,
-  fromPlain as ac,
-  previewLinks as ad,
-  slugify as ae,
-  readPreviewComment as af,
-  findPreviewComment as ag,
-  previewsSettled as ah,
-  AAA_MIN as ai,
-  AA_MIN as aj,
-  BULK_LIMIT as ak,
-  CONTRAST_CELL_MAX as al,
-  CONTRAST_CHECKS_FILE as am,
-  DEFAULT_COMPONENT_SPECS_FILE as an,
-  DEFAULT_GOVERNANCE as ao,
-  DEFAULT_OVERRIDE as ap,
-  DEFAULT_RIGHTS as aq,
-  DEFAULT_VISUAL_IMPACT as ar,
-  JsonParseError as as,
-  OWNER_GROUPS as at,
-  PREVIEW_APP_LABELS as au,
-  PREVIEW_COMMENT_MARKER as av,
-  PREVIEW_PLACEHOLDERS as aw,
-  PRIMITIVE_MODE as ax,
-  RIGHTS as ay,
-  RIGHT_LABEL as az,
+  composeProposalBody as a$,
+  resolveBranchPreviews as a0,
+  tokensPath as a1,
+  coerceValue as a2,
+  toConfigJson as a3,
+  parseContrastChecks as a4,
+  checkLayeredPair as a5,
+  classifyRisk as a6,
+  formatChangeset as a7,
+  RISK_LABELS as a8,
+  parseJson as a9,
+  RIGHTS as aA,
+  RIGHT_LABEL as aB,
+  RISK_TIER as aC,
+  SPEC_FIELDS as aD,
+  TIER_ORDER as aE,
+  TeamDirectory as aF,
+  UNRELEASED as aG,
+  VISUAL_CHECK_LABEL as aH,
+  affectedContrast as aI,
+  appForProject as aJ,
+  appUrl as aK,
+  approverEntries as aL,
+  approverLists as aM,
+  assignVersions as aN,
+  baseBranchOf as aO,
+  branchName as aP,
+  branchSlug as aQ,
+  canShip as aR,
+  changeKind as aS,
+  changeTable as aT,
+  changedModes as aU,
+  changesetBump as aV,
+  classifyLayered as aW,
+  clearRawDeep as aX,
+  commitMessage as aY,
+  composeChangeset as aZ,
+  composePrBody as a_,
+  serializeJson as aa,
+  plainEqual as ab,
+  toPlain as ac,
+  getEntry as ad,
+  fromPlain as ae,
+  previewLinks as af,
+  slugify as ag,
+  readPreviewComment as ah,
+  findPreviewComment as ai,
+  previewsSettled as aj,
+  AAA_MIN as ak,
+  AA_MIN as al,
+  BULK_LIMIT as am,
+  CONTRAST_CELL_MAX as an,
+  CONTRAST_CHECKS_FILE as ao,
+  DEFAULT_COMPONENT_SPECS_FILE as ap,
+  DEFAULT_GOVERNANCE as aq,
+  DEFAULT_OVERRIDE as ar,
+  DEFAULT_RIGHTS as as,
+  DEFAULT_VISUAL_IMPACT as at,
+  JsonParseError as au,
+  OWNER_GROUPS as av,
+  PREVIEW_APP_LABELS as aw,
+  PREVIEW_COMMENT_MARKER as ax,
+  PREVIEW_PLACEHOLDERS as ay,
+  PRIMITIVE_MODE as az,
   parseChangelog as b,
-  tarballAssetName as b$,
-  contrastDelta as b0,
-  contrastDeltaTable as b1,
-  contrastLevel as b2,
-  contrastPair as b3,
-  contrastRatio as b4,
-  countChanges as b5,
-  defaultContext as b6,
-  defaultTitle as b7,
-  defineConfig as b8,
-  detectLayout as b9,
-  luminance as bA,
-  modeLabel as bB,
-  nodesEqual as bC,
-  normalizeRights as bD,
-  overrideKey as bE,
-  ownerEntryProblems as bF,
-  pairKey as bG,
-  parseChangesetText as bH,
-  parseComponentSpecs as bI,
-  parseOwnerEntry as bJ,
-  parseVercelComment as bK,
-  planRestore as bL,
-  planRevert as bM,
-  planToJson as bN,
-  previewComment as bO,
-  previewLinksOf as bP,
-  previewUrl as bQ,
-  projectOfLabel as bR,
-  protectedBranchesOf as bS,
-  renderedColor as bT,
-  rightsProblems as bU,
-  runLayeredContrast as bV,
-  sameToken as bW,
-  shipPolicy as bX,
-  snapshotUrl as bY,
-  specHash as bZ,
-  summarizeTokenChange as b_,
-  diffLayered as ba,
-  entriesFor as bb,
-  entryLabel as bc,
-  expandEntries as bd,
-  expandOwners as be,
-  fieldChanges as bf,
-  fileModes as bg,
-  filterHistory as bh,
-  findToken as bi,
-  findVercelComment as bj,
-  firstParagraph as bk,
-  formatNumber as bl,
-  formatOwnerEntry as bm,
-  getChild as bn,
-  groupsPhrase as bo,
-  holdersOf as bp,
-  indexByPath as bq,
-  inheritedTypeAt as br,
-  installCommand as bs,
-  installCommandFromPreviewComment as bt,
-  isGuardrail as bu,
-  isTeamEntry as bv,
-  isTokenFile as bw,
-  isVercelComment as bx,
-  kindForMin as by,
-  layeredImpact as bz,
+  snapshotUrl as b$,
+  composite as b0,
+  contextFor as b1,
+  contrastDelta as b2,
+  contrastDeltaTable as b3,
+  contrastLevel as b4,
+  contrastPair as b5,
+  contrastRatio as b6,
+  countChanges as b7,
+  coverageSummary as b8,
+  defaultContext as b9,
+  isVercelComment as bA,
+  kindForMin as bB,
+  layeredImpact as bC,
+  luminance as bD,
+  modeLabel as bE,
+  nodesEqual as bF,
+  normalizeRights as bG,
+  overrideKey as bH,
+  ownerEntryProblems as bI,
+  pairKey as bJ,
+  parseChangesetText as bK,
+  parseComponentSpecs as bL,
+  parseOwnerEntry as bM,
+  parseVercelComment as bN,
+  planRestore as bO,
+  planRevert as bP,
+  planToJson as bQ,
+  previewComment as bR,
+  previewLinksOf as bS,
+  previewUrl as bT,
+  projectOfLabel as bU,
+  protectedBranchesOf as bV,
+  renderedColor as bW,
+  rightsProblems as bX,
+  runLayeredContrast as bY,
+  sameToken as bZ,
+  shipPolicy as b_,
+  defaultTitle as ba,
+  defineConfig as bb,
+  detectLayout as bc,
+  diffLayered as bd,
+  entriesFor as be,
+  entryLabel as bf,
+  expandEntries as bg,
+  expandOwners as bh,
+  fieldChanges as bi,
+  fileModes as bj,
+  filterHistory as bk,
+  findToken as bl,
+  findVercelComment as bm,
+  firstParagraph as bn,
+  formatNumber as bo,
+  formatOwnerEntry as bp,
+  getChild as bq,
+  groupsPhrase as br,
+  holdersOf as bs,
+  indexByPath as bt,
+  inheritedTypeAt as bu,
+  installCommand as bv,
+  installCommandFromPreviewComment as bw,
+  isGuardrail as bx,
+  isTeamEntry as by,
+  isTokenFile as bz,
   collectHistory as c,
-  tarballUrl as c0,
-  teamKey as c1,
-  teamKeyOf as c2,
-  teamUnreadableMessage as c3,
-  teamsIn as c4,
-  titleOf as c5,
-  toChangeSummary as c6,
-  toMap as c7,
-  tokenBump as c8,
-  tokenHistory as c9,
-  tokenNode as ca,
-  unreadableShipTeams as cb,
-  unreadableTeams as cc,
-  valueIn as cd,
-  variantName as ce,
-  versionTimeline as cf,
-  visualImpactProblems as cg,
-  whoCanShipSentence as ch,
+  summarizeTokenChange as c0,
+  tarballAssetName as c1,
+  tarballUrl as c2,
+  teamKey as c3,
+  teamKeyOf as c4,
+  teamUnreadableMessage as c5,
+  teamsIn as c6,
+  titleOf as c7,
+  toChangeSummary as c8,
+  toMap as c9,
+  tokenBump as ca,
+  tokenHistory as cb,
+  tokenNode as cc,
+  unreadableShipTeams as cd,
+  unreadableTeams as ce,
+  valueIn as cf,
+  variantName as cg,
+  versionTimeline as ch,
+  visualImpactProblems as ci,
+  whoCanShipSentence as cj,
   buildReport as d,
   prNumberFromSubject as e,
-  CONFIG_FILE as f,
+  variantKeyOf as f,
   layoutOptions as g,
   hashSpec as h,
-  buildTokenSet as i,
-  iconComponentName as j,
-  COLOR_FIELDS as k,
+  iconComponentName as i,
+  buildTokenSet as j,
+  COMPONENT_SPECS_VERSION as k,
   loadConfig as l,
   mergeReleases as m,
-  modeDisplayName as n,
-  modesOf as o,
+  COLOR_FIELDS as n,
+  modeDisplayName as o,
   packageDirCandidates as p,
-  isMultiMode as q,
+  modesOf as q,
   releasesFromTags as r,
-  TIER_AXIS as s,
+  specHash as s,
   tokenCssVar as t,
-  findReferenceProblems as u,
-  variantKeyOf as v,
-  evaluatePairs as w,
-  contrastScope as x,
-  contextLabel as y,
-  pathId as z
+  isMultiMode as u,
+  validateComponentSpec as v,
+  TIER_AXIS as w,
+  findReferenceProblems as x,
+  evaluatePairs as y,
+  contrastScope as z
 };
-//# sourceMappingURL=component-spec-cvrSvIZj.js.map
+//# sourceMappingURL=component-spec-GFVEE6Fc.js.map