@plus234feed/ds 0.5.0 → 0.7.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plus234feed/ds",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "description": "Plus234Feed design system. Editorial tokens, type scale and components for a news intelligence platform: newspaper hierarchy, accessible colour in both themes, one component per job.",
   "keywords": [
     "design-system",

package/src/components.css

@@ -280,6 +280,43 @@
 .p234-delta[data-direction="up"]::before { content: "\25B2 "; }
 .p234-delta[data-direction="down"]::before { content: "\25BC "; }
 
+/* On a cost page a rise is the bad news.
+ *
+ * The default above is a market reading: up is green because a price you hold
+ * went up. On petrol, food, transport and the cost of a healthy diet the same
+ * arrow means a household pays more, so the two colours swap. The arrow still
+ * points the way the number moved; only good and bad change places.
+ *
+ * This existed as a helper in the application for a while, which meant the
+ * next cost page would have invented its own. */
+.p234-delta--cost[data-direction="up"] { color: var(--p234-color-data-down); }
+.p234-delta--cost[data-direction="down"] { color: var(--p234-color-data-up); }
+
+/* --- meter -------------------------------------------------------------
+   An inline bar for one value's share of a whole: a food group's share of a
+   daily diet, a party's share of a vote, a source's share of coverage.
+
+   Not to be confused with .p234-progress, which is the fixed reading bar
+   pinned to the top of the viewport. Using that one inline stacks every bar
+   on the page at the top of the screen, which is exactly what happened the
+   first time this was needed.
+
+   The share is carried by an aria-label on the element, because a bar on its
+   own is read out as nothing at all. */
+.p234-meter {
+  display: block;
+  height: var(--p234-border-thick);
+  background: var(--p234-color-rule);
+  overflow: hidden;
+}
+.p234-meter__fill {
+  display: block;
+  height: 100%;
+  background: var(--p234-color-brand);
+}
+/* A second series in the same list, for a comparison bar under the first. */
+.p234-meter__fill--alt { background: var(--p234-color-ink-subtle); }
+
 .p234-table {
   width: 100%;
   border-collapse: collapse;
@@ -315,8 +352,21 @@
   max-width: var(--p234-measure-text);
 }
 .p234-prose > * + * { margin-top: var(--p234-space-5); }
-.p234-prose a { color: var(--p234-color-link); text-underline-offset: 2px; }
-.p234-prose a:visited { color: var(--p234-color-link-visited); }
+/* Links in running text, meaning links with no styling of their own.
+ *
+ * `.p234-prose a` is a class and a type, which outranks the single class on
+ * `.p234-btn`, so without this guard a button inside prose takes the link
+ * colour: brand green text on a brand green fill, which renders as an empty
+ * green rectangle. The same applied to a tag, a toggle and a directory row.
+ *
+ * The guard excludes any link carrying a class, not only a p234- one, because
+ * the first version missed a link styled by the host application's own
+ * utilities and it went green on green too. The rule is now simply: an
+ * unstyled link gets prose styling, and a link with a class styles itself.
+ * `:not([class])` rather than `:where()` so it does not depend on whether
+ * this stylesheet is imported before or after the host's reset. */
+.p234-prose a:not([class]) { color: var(--p234-color-link); text-underline-offset: 2px; }
+.p234-prose a:not([class]):visited { color: var(--p234-color-link-visited); }
 .p234-prose blockquote {
   font-family: var(--p234-type-quote-family);
   font-size: var(--p234-type-quote-size);
@@ -461,7 +511,10 @@
   font-weight: 700;
   color: var(--p234-color-brand);
 }
-.p234-nextstep a {
+/* Same guard as prose: a link that is already a component keeps its own
+   colour. Without it a button or tag dropped into this box would be styled
+   as one of the box's own link rows. */
+.p234-nextstep a:not([class]) {
   font-family: var(--p234-type-headline-xs-family);
   font-size: var(--p234-type-headline-xs-size);
   line-height: var(--p234-type-headline-xs-leading);
@@ -469,7 +522,7 @@
   color: var(--p234-color-ink);
   text-decoration: none;
 }
-.p234-nextstep a:hover { text-decoration: underline; text-underline-offset: 2px; }
+.p234-nextstep a:not([class]):hover { text-decoration: underline; text-underline-offset: 2px; }
 
 /* --- breadcrumb --------------------------------------------------------
    34 files hand-roll this today, each with its own separator and spacing. */
@@ -493,8 +546,8 @@
   content: "/";
   color: var(--p234-color-rule-strong);
 }
-.p234-breadcrumb a { color: var(--p234-color-ink-muted); text-decoration: none; }
-.p234-breadcrumb a:hover { color: var(--p234-color-ink); text-decoration: underline; text-underline-offset: 2px; }
+.p234-breadcrumb a:not([class]) { color: var(--p234-color-ink-muted); text-decoration: none; }
+.p234-breadcrumb a:not([class]):hover { color: var(--p234-color-ink); text-decoration: underline; text-underline-offset: 2px; }
 .p234-breadcrumb [aria-current="page"] { color: var(--p234-color-ink); }
 
 /* --- figure ------------------------------------------------------------
@@ -711,7 +764,7 @@
   justify-content: center;
   gap: var(--p234-space-5);
 }
-.p234-masthead__editions a {
+.p234-masthead__editions a:not([class]) {
   font-family: var(--p234-type-ui-sm-family);
   font-size: var(--p234-type-ui-sm-size);
   font-weight: 600;
@@ -722,7 +775,7 @@
   white-space: nowrap;
 }
 .p234-masthead__editions a:hover,
-.p234-masthead__editions a[aria-current] { color: var(--p234-color-ink); }
+.p234-masthead__editions a:not([class])[aria-current] { color: var(--p234-color-ink); }
 
 /* Row 2: the wordmark, centred. */
 .p234-masthead__bar {
@@ -840,13 +893,13 @@
 }
 .p234-megamenu ul { list-style: none; margin: 0; padding: 0; }
 .p234-megamenu li { margin-bottom: var(--p234-space-4); }
-.p234-megamenu a {
+.p234-megamenu a:not([class]) {
   font-family: var(--p234-type-ui-family);
   font-size: var(--p234-type-ui-size);
   color: var(--p234-color-ink);
   text-decoration: none;
 }
-.p234-megamenu a:hover { text-decoration: underline; text-underline-offset: 2px; }
+.p234-megamenu a:not([class]):hover { text-decoration: underline; text-underline-offset: 2px; }
 
 /* The phone drawer: a full screen panel, search first, then the sections as
    accordions. <details> so it works with no JavaScript. */
@@ -880,7 +933,7 @@
   gap: var(--p234-space-4);
   padding-bottom: var(--p234-space-5);
 }
-.p234-drawer__links a {
+.p234-drawer__links a:not([class]) {
   font-family: var(--p234-type-ui-family);
   font-size: var(--p234-type-ui-size);
   color: var(--p234-color-ink);
@@ -905,7 +958,7 @@
   max-width: var(--p234-layout-container);
   margin-inline: auto;
 }
-.p234-subnav a {
+.p234-subnav a:not([class]) {
   display: block;
   font-family: var(--p234-type-ui-sm-family);
   font-size: var(--p234-type-ui-sm-size);
@@ -917,8 +970,8 @@
   border-bottom: var(--p234-border-thick) solid transparent;
   margin-bottom: -1px;
 }
-.p234-subnav a:hover { color: var(--p234-color-ink); }
-.p234-subnav a[aria-current] {
+.p234-subnav a:not([class]):hover { color: var(--p234-color-ink); }
+.p234-subnav a:not([class])[aria-current] {
   color: var(--p234-color-ink);
   border-bottom-color: var(--p234-color-brand);
 }
@@ -984,13 +1037,13 @@
 }
 .p234-footer ul { list-style: none; margin: 0; padding: 0; }
 .p234-footer li { margin-bottom: var(--p234-space-3); }
-.p234-footer a {
+.p234-footer a:not([class]) {
   font-family: var(--p234-type-ui-sm-family);
   font-size: var(--p234-type-ui-sm-size);
   color: var(--p234-color-ink);
   text-decoration: none;
 }
-.p234-footer a:hover { text-decoration: underline; text-underline-offset: 2px; }
+.p234-footer a:not([class]):hover { text-decoration: underline; text-underline-offset: 2px; }
 .p234-footer__legal {
   border-top: var(--p234-border-hairline) solid var(--p234-color-rule);
   padding-top: var(--p234-space-5);
@@ -1550,7 +1603,7 @@ textarea.p234-field__control {
   margin: 0;
   padding: 0;
 }
-.p234-linkgrid a {
+.p234-linkgrid a:not([class]) {
   display: block;
   border-top: var(--p234-border-thick) solid var(--p234-color-ink);
   padding-top: var(--p234-space-3);
@@ -1560,7 +1613,7 @@ textarea.p234-field__control {
   color: var(--p234-color-ink);
   text-decoration: none;
 }
-.p234-linkgrid a:hover { color: var(--p234-color-brand); }
+.p234-linkgrid a:not([class]):hover { color: var(--p234-color-brand); }
 .p234-linkgrid__count {
   display: block;
   font-family: var(--p234-type-meta-family);