@orangecheck/design 0.21.0 → 0.23.0

package/README.md

@@ -21,10 +21,14 @@ Canonical design + rollout plan: `~/Projects/ochk/DESIGN-SYSTEM-PLAN.md`.
 
 - **Mode** — `light | dark`, owned by `next-themes` via the `.dark` class. Toggle
   with `<ThemeToggle />`. Unchanged from today.
-- **Skin** — a named theme (`orangecheck` default, `midnight`, …), owned by
-  `<OcThemeProvider>` via the `data-oc-theme` attribute, persisted in the
-  `oc_skin` cookie at `Domain=.ochk.io` so a choice carries across every family
-  site. Pick with `<OcThemePicker />`.
+- **Skin** — a named theme, owned by `<OcThemeProvider>` via the `data-oc-theme`
+  attribute, persisted in the `oc_skin` cookie at `Domain=.ochk.io` so a choice
+  carries across every family site. Pick with `<OcThemePicker />`. Five skins
+  ship: **`ember`** — the family **default** (a warm, rounded consumer skin:
+  terracotta, 1rem radius, pill buttons, self-hosted Hanken Grotesk; owns the
+  bare `:root`/`.dark` base) — plus `orangecheck`, `phosphor`, `lightning`,
+  `gold` (the four sharp/flat Bitcoin-ethos alternates, attribute-only arms). A
+  skin re-skins color, radius, type, and elevation — not just hue.
 
 The two compose: any skin renders in both modes.
 
@@ -65,15 +69,32 @@ Header (gate the picker behind a flag during staged rollout):
 ```
 
 Fonts are still loaded by the app via `next/font` into `--font-sans-display`
-and `--font-mono-display`, exactly as before.
+and `--font-mono-display`, exactly as before — the default skins defer to them.
+A skin may instead **self-host its own font in-package**: `ember` ships Hanken
+Grotesk as a variable woff2 under `src/styles/fonts/`, declared in
+`src/styles/fonts.css` (imported first by `styles.css`). Tailwind v4 (Lightning
+CSS) rebases the relative `url()` on `@import`, so the woff2 emits through every
+consumer's build with **zero per-site `next/font` wiring**; the browser only
+fetches it when ember is the active skin.
 
 ## Adding a skin
 
 1. Add `src/styles/themes/<id>.css` declaring the full token set for both modes
-   (under `[data-oc-theme='<id>']` and `[data-oc-theme='<id>'].dark`).
+   (under `[data-oc-theme='<id>']` and `[data-oc-theme='<id>'].dark`). Scope every
+   selector to the two `[data-oc-theme='<id>']` arms — never touch bare `:root`/
+   `.dark`, or you re-skin the default.
 2. `@import` it from `src/styles/themes.css`.
-3. Add a row to `OC_THEMES` in `src/tokens/themes.ts`.
-4. Publish. Every site picks it up on the next Renovate bump — no per-site edits.
+3. Add a row to `OC_THEMES` in `src/tokens/themes.ts` (this auto-populates the
+   appearance menu, picker, Storybook toolbar, and favicon recolor).
+4. Add the id to the hardcoded `SKINS` arrays in `scripts/verify-themes.mjs` +
+   `scripts/verify-contrast.mjs`, then `yarn verify` (asserts the skin is
+   distinct and AA-clean in both modes).
+5. (Optional) self-host a font: see the Hanken Grotesk note above.
+6. Publish. Every site picks it up on the next Renovate bump — no per-site edits.
+
+A skin is **opt-in** by default — shipping one makes it a picker option, not the
+default. Changing `DEFAULT_OC_THEME` (family-wide) or a per-site
+`<OcThemeProvider defaultSkin>` is a separate, deliberate flip.
 
 ## Build
 

package/dist/components.d.mts

@@ -1,4 +1,4 @@
-export { AccentList, AccentListItem, AccentListProps, AccentNote, AccentNoteProps, BrandBand, Callout, CalloutProps, CalloutTone, CheckList, CheckListProps, ComparisonRow, ComparisonTable, ComparisonTableProps, DataRow, DataRowProps, DefinitionItem, DefinitionList, DefinitionListProps, EmailCapture, EmailCaptureProps, EmptyState, EmptyStateCta, EmptyStateProps, Faq, FaqItem, FaqProps, FeatureCard, FeatureCardProps, HelpHint, HelpHintProps, MarketingHeading, MarketingHeadingProps, NumberedStep, NumberedStepProps, Section, SectionHeader, SectionHeaderProps, SectionProps, StatCard, StatCardProps, StatGrid, StatGridProps, StatItem, StatTile, Step, StepList, StepListProps, TwoToneHeading, TwoToneHeadingProps, VerifiedChip, VerifiedChipProps } from './composites.mjs';
+export { AccentList, AccentListItem, AccentListProps, AccentNote, AccentNoteProps, BrandBand, Callout, CalloutProps, CalloutTone, CheckList, CheckListProps, ComparisonRow, ComparisonTable, ComparisonTableProps, DataRow, DataRowProps, DefinitionItem, DefinitionList, DefinitionListProps, EmailCapture, EmailCaptureProps, EmptyState, EmptyStateCta, EmptyStateProps, Faq, FaqItem, FaqProps, FeatureCard, FeatureCardProps, HelpHint, HelpHintProps, MarketingHeading, MarketingHeadingProps, NumberedStep, NumberedStepProps, Panel, PanelProps, Section, SectionHeader, SectionHeaderProps, SectionProps, StatCard, StatCardProps, StatGrid, StatGridProps, StatItem, StatTile, Step, StepList, StepListProps, TwoToneHeading, TwoToneHeadingProps, VerifiedChip, VerifiedChipProps } from './composites.mjs';
 export { AppShell, AppShellProps, EcosystemSlug, EcosystemSwitcher, EcosystemSwitcherProps, FAMILY_PROPERTIES, FamilyCategory, FamilyProperty, LayoutSubHeader, LayoutSubHeaderProps, LayoutSubHeaderTag, OcAccountMenu, OcAccountMenuBuildInfo, OcAccountMenuItem, OcAccountMenuProps, OcAccountMenuSession, OcAccountMenuView, OcAccountMenuViewProps, OcAppBar, OcAppBarProps, OcDashboardHub, OcDashboardHubProps, OcDashboardShell, OcDashboardShellProps, OcDashboardTool, OcLogoDropdown, OcLogoDropdownProps, OcPrimaryNav, OcPrimaryNavLink, OcPrimaryNavProps, SITE_STATE_LABEL, SiteState, findFamilyProperty } from './chrome.mjs';
 import 'react/jsx-runtime';
 import 'react';

package/dist/components.d.ts

@@ -1,4 +1,4 @@
-export { AccentList, AccentListItem, AccentListProps, AccentNote, AccentNoteProps, BrandBand, Callout, CalloutProps, CalloutTone, CheckList, CheckListProps, ComparisonRow, ComparisonTable, ComparisonTableProps, DataRow, DataRowProps, DefinitionItem, DefinitionList, DefinitionListProps, EmailCapture, EmailCaptureProps, EmptyState, EmptyStateCta, EmptyStateProps, Faq, FaqItem, FaqProps, FeatureCard, FeatureCardProps, HelpHint, HelpHintProps, MarketingHeading, MarketingHeadingProps, NumberedStep, NumberedStepProps, Section, SectionHeader, SectionHeaderProps, SectionProps, StatCard, StatCardProps, StatGrid, StatGridProps, StatItem, StatTile, Step, StepList, StepListProps, TwoToneHeading, TwoToneHeadingProps, VerifiedChip, VerifiedChipProps } from './composites.js';
+export { AccentList, AccentListItem, AccentListProps, AccentNote, AccentNoteProps, BrandBand, Callout, CalloutProps, CalloutTone, CheckList, CheckListProps, ComparisonRow, ComparisonTable, ComparisonTableProps, DataRow, DataRowProps, DefinitionItem, DefinitionList, DefinitionListProps, EmailCapture, EmailCaptureProps, EmptyState, EmptyStateCta, EmptyStateProps, Faq, FaqItem, FaqProps, FeatureCard, FeatureCardProps, HelpHint, HelpHintProps, MarketingHeading, MarketingHeadingProps, NumberedStep, NumberedStepProps, Panel, PanelProps, Section, SectionHeader, SectionHeaderProps, SectionProps, StatCard, StatCardProps, StatGrid, StatGridProps, StatItem, StatTile, Step, StepList, StepListProps, TwoToneHeading, TwoToneHeadingProps, VerifiedChip, VerifiedChipProps } from './composites.js';
 export { AppShell, AppShellProps, EcosystemSlug, EcosystemSwitcher, EcosystemSwitcherProps, FAMILY_PROPERTIES, FamilyCategory, FamilyProperty, LayoutSubHeader, LayoutSubHeaderProps, LayoutSubHeaderTag, OcAccountMenu, OcAccountMenuBuildInfo, OcAccountMenuItem, OcAccountMenuProps, OcAccountMenuSession, OcAccountMenuView, OcAccountMenuViewProps, OcAppBar, OcAppBarProps, OcDashboardHub, OcDashboardHubProps, OcDashboardShell, OcDashboardShellProps, OcDashboardTool, OcLogoDropdown, OcLogoDropdownProps, OcPrimaryNav, OcPrimaryNavLink, OcPrimaryNavProps, SITE_STATE_LABEL, SiteState, findFamilyProperty } from './chrome.js';
 import 'react/jsx-runtime';
 import 'react';

package/dist/components.js

@@ -179,11 +179,11 @@ var COL_CLASS = {
   4: "md:grid-cols-2 lg:grid-cols-4"
 };
 function StatGrid({ items, columns = 3, className = "" }) {
-  return /* @__PURE__ */ jsxRuntime.jsx("div", { className: `bg-border grid gap-px border ${COL_CLASS[columns]} ${className}`, children: items.map((it, i) => /* @__PURE__ */ jsxRuntime.jsx(Tile, { item: it }, `${it.label}-${i}`)) });
+  return /* @__PURE__ */ jsxRuntime.jsx("div", { className: `oc-stat-grid bg-border grid gap-px border ${COL_CLASS[columns]} ${className}`, children: items.map((it, i) => /* @__PURE__ */ jsxRuntime.jsx(Tile, { item: it }, `${it.label}-${i}`)) });
 }
 function Tile({ item }) {
   const tone = item.tone ?? (item.accent ? "primary" : "default");
-  return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "bg-background p-5", children: [
+  return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "oc-stat-tile bg-background p-5", children: [
     /* @__PURE__ */ jsxRuntime.jsx("div", { className: "text-muted-foreground/80 font-mono text-[10px] tracking-widest uppercase", children: item.label }),
     /* @__PURE__ */ jsxRuntime.jsx(
       "div",
@@ -236,7 +236,7 @@ function StatBlock({ label, value, sub, delta, tone = "default", className }) {
   ] });
 }
 function StatCard({ pad = "default", className, ...stat }) {
-  return /* @__PURE__ */ jsxRuntime.jsx("div", { className: cn("border bg-card", pad === "sm" ? "p-3 md:p-4" : "p-5", className), children: /* @__PURE__ */ jsxRuntime.jsx(StatBlock, { ...stat }) });
+  return /* @__PURE__ */ jsxRuntime.jsx("div", { className: cn("oc-stat-card border bg-card", pad === "sm" ? "p-3 md:p-4" : "p-5", className), children: /* @__PURE__ */ jsxRuntime.jsx(StatBlock, { ...stat }) });
 }
 var FRAME = {
   info: "border-primary/30 bg-primary/5",
@@ -273,7 +273,7 @@ function DefinitionList({ items, className }) {
     "dl",
     {
       className: cn(
-        "grid gap-x-5 gap-y-2 text-sm sm:grid-cols-[auto_1fr] sm:items-baseline",
+        "oc-deflist grid gap-x-5 gap-y-2 text-sm sm:grid-cols-[auto_1fr] sm:items-baseline",
         className
       ),
       children: items.map((item, i) => /* @__PURE__ */ jsxRuntime.jsxs(React2.Fragment, { children: [
@@ -289,7 +289,7 @@ function DataRow({ children, meta, action, as, className }) {
     Tag,
     {
       className: cn(
-        "flex flex-col gap-1 py-3 sm:flex-row sm:items-baseline sm:justify-between sm:gap-4",
+        "oc-data-row flex flex-col gap-1 py-3 sm:flex-row sm:items-baseline sm:justify-between sm:gap-4",
         className
       ),
       children: [
@@ -302,6 +302,19 @@ function DataRow({ children, meta, action, as, className }) {
     }
   );
 }
+function Panel({ label, title, action, flush, className, children }) {
+  const hasHeader = label || title || action;
+  return /* @__PURE__ */ jsxRuntime.jsxs("section", { className: cn("oc-panel py-8", !flush && "border-t", className), children: [
+    hasHeader && /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "mb-4 flex items-start justify-between gap-3", children: [
+      /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "min-w-0", children: [
+        label && /* @__PURE__ */ jsxRuntime.jsx("div", { className: "label-mono text-primary mb-1", children: label }),
+        title && /* @__PURE__ */ jsxRuntime.jsx("h2", { className: "font-display text-lg font-bold tracking-tight", children: title })
+      ] }),
+      action && /* @__PURE__ */ jsxRuntime.jsx("div", { className: "shrink-0", children: action })
+    ] }),
+    children
+  ] });
+}
 function TwoToneHeading({
   lead,
   muted,
@@ -311,7 +324,7 @@ function TwoToneHeading({
 }) {
   const Tag = as ?? "h2";
   const leadColor = tone === "onBrand" ? "text-primary-foreground" : "text-foreground";
-  const mutedColor = tone === "onBrand" ? "text-primary-foreground/60" : "text-foreground/40";
+  const mutedColor = tone === "onBrand" ? "text-primary-foreground/75" : "text-foreground/40";
   return /* @__PURE__ */ jsxRuntime.jsxs(
     Tag,
     {
@@ -3000,6 +3013,7 @@ exports.OcDashboardHub = OcDashboardHub;
 exports.OcDashboardShell = OcDashboardShell;
 exports.OcLogoDropdown = OcLogoDropdown;
 exports.OcPrimaryNav = OcPrimaryNav;
+exports.Panel = Panel;
 exports.SITE_STATE_LABEL = SITE_STATE_LABEL;
 exports.Section = Section;
 exports.SectionHeader = SectionHeader;