@riverbankcms/sdk 0.130.0 → 0.132.0

package/dist/_dts/theme-core/src/cards/siteStyleDefaults.d.ts

@@ -1,14 +1,16 @@
+import type { CardSystem } from './types';
 /**
  * Reusable card systems for curated site styles.
  *
- * generateCardCss emits a `.card-{id}` class per enabled variant. The
- * intended convention (block-level role selection is wired in a follow-up) is
- * a role pair:
+ * generateCardCss emits a `.card-{id}` class per enabled variant, plus stable
+ * `.card-role-{role}` aliases resolved through the fallback chain. Each variant
+ * declares which role it implements:
  *   - `default`     — the quiet, everyday card (most blocks, most of the time)
  *   - `alternative` — the prominent "statement" card for sections that pop
- * A card-heavy site style may add a third; the schema allows up to three
- * variants. The planned fallback when a block references a missing variant is
- * `alternative`, then `default`.
+ *   - `open`        — boxless but marked; falls back to the generated baseline
+ * The schema allows three variants, one per role. A block asking for a role a
+ * site style does not define falls back per `resolveCardRole`: `alternative` →
+ * `default` → generated baseline.
  *
  * Keep `default` close to the generated baseline so shared consumers (event
  * cards, testimonials) stay stable; put the personality in `alternative`.
@@ -25,6 +27,7 @@ export declare const southWestCardSystem: {
         readonly name: "Default";
         readonly enabled: true;
         readonly priority: 1;
+        readonly role: "default";
         readonly background: {
             readonly type: "solid";
             readonly colorToken: "surface";
@@ -42,6 +45,7 @@ export declare const southWestCardSystem: {
         readonly name: "Statement";
         readonly enabled: true;
         readonly priority: 2;
+        readonly role: "alternative";
         readonly background: {
             readonly type: "solid";
             readonly colorToken: "primary-700";
@@ -53,11 +57,12 @@ export declare const southWestCardSystem: {
             readonly softness: null;
             readonly position: "bottom";
         };
-        readonly accentEdge: {
+        readonly decorations: [{
             readonly edge: "left";
             readonly colorToken: "secondary";
             readonly width: "heavy";
-        };
+            readonly length: "full";
+        }];
         readonly cornerRadii: {
             readonly topLeft: "square";
             readonly topRight: "expressive";
@@ -72,6 +77,7 @@ export declare const clarityZenCardSystem: {
         readonly name: "Default";
         readonly enabled: true;
         readonly priority: 1;
+        readonly role: "default";
         readonly background: {
             readonly type: "solid";
             readonly colorToken: "surface";
@@ -89,6 +95,7 @@ export declare const clarityZenCardSystem: {
         readonly name: "Statement";
         readonly enabled: true;
         readonly priority: 2;
+        readonly role: "alternative";
         readonly background: {
             readonly type: "solid";
             readonly colorToken: "surfaceAlt";
@@ -103,6 +110,42 @@ export declare const clarityZenCardSystem: {
         };
     }];
 };
+/**
+ * Grounded Practice: the first site style to own the `open` role.
+ *
+ * `default` and `alternative` restate the generated baseline this style's token
+ * recipes already produce (soft corners, flat surface card, tinted statement
+ * card, hairline border) so nothing that renders today moves — declaring a card
+ * system means the `.card-{id}` classes must keep existing for event and
+ * offering cards.
+ *
+ * `open` is the change, and it is the one place this style deliberately
+ * diverges from `boxlessOpenCardVariant` (the generated baseline's
+ * hairline-plus-short-accent marking). Grounded Practice takes Luna's
+ * therapy-page card literally
+ * (`apps/dashboard/scripts/design-bakeoff/results/studies/anna-raven-yoga-20260713-115605Z/revisions/005/index.html`,
+ * `.fit__card`: `padding: 1.6rem 1.45rem 1.75rem; border-top: 2px solid
+ * var(--ochre); background: rgba(242,243,235,.72)`):
+ *
+ * - one **full-length 2px** rule in the style's ochre `accent` (`#c69a3c` —
+ *   the mockup's `--ochre`); `width: 'thin'` is the 2px step in
+ *   `CARD_EDGE_RULE_WIDTH_MAP`. No hairline underneath and no short marker:
+ *   the single rule *is* the marking.
+ * - a light solid fill. Card backgrounds take no alpha, so the token that
+ *   reads like the mockup's translucent pale tint is `surfaceAlt`
+ *   (`#f2ecdb`), which sits one step lighter than the `muted` band the
+ *   Look now paints — the same lift Luna gets from `rgba(242,243,235,.72)`
+ *   over `--ground-2`.
+ * - comfortable spacing on both axes. The baseline keeps `inline: 'none'`
+ *   so a boxless card stays flush with the section; a filled card needs its
+ *   padding back or the text touches the fill's edge.
+ *
+ * The baseline `boxlessOpenCardVariant` is unchanged — this divergence is
+ * grounded-practice's alone. See
+ * `.project/plans/1297-card-role-contract-site-styles-own-card-surfaces/decisions.md`
+ * §0.7 and "Phase 2.4".
+ */
+export declare const groundedPracticeCardSystem: CardSystem;
 /**
  * Original Joy: warm, flat, generously rounded cards on the dark clay ground.
  * `default` is a quiet brown surface card with cream text; `alternative` is a
@@ -116,6 +159,7 @@ export declare const originalJoyCardSystem: {
         readonly name: "Default";
         readonly enabled: true;
         readonly priority: 1;
+        readonly role: "default";
         readonly background: {
             readonly type: "solid";
             readonly colorToken: "surface";
@@ -133,6 +177,7 @@ export declare const originalJoyCardSystem: {
         readonly name: "Statement";
         readonly enabled: true;
         readonly priority: 2;
+        readonly role: "alternative";
         readonly background: {
             readonly type: "solid";
             readonly colorToken: "primary";