@riverbankcms/sdk 0.130.0 → 0.130.2

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

@@ -6,9 +6,14 @@ import type { CardSystem } from './types';
  * Creates the baseline card roles that blocks can request:
  * - `default` for everyday surfaced cards
  * - `alternative` for emphasised cards
+ * - `open` for boxless-but-marked cards
  *
- * Both variants explicitly set theme.shadow and theme.corners for runtime
- * transform access, and both use theme.border when it has meaningful width.
+ * This is the terminal arm of the role fallback chain, so every theme
+ * implements every surface role whether or not its site style defines cards.
+ *
+ * The surfaced variants explicitly set theme.shadow and theme.corners for
+ * runtime transform access, and both use theme.border when it has meaningful
+ * width.
  *
  * This ensures cards have sensible defaults even when theme.cards is undefined.
  *

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

@@ -1,5 +1,8 @@
 export * from './types';
 export * from './constants';
+export * from './decorations';
+export * from './roles';
+export * from './openCardVariant';
 export * from './generateCardCss';
 export * from './generateDefaultCardSystem';
 export * from './core';

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

@@ -0,0 +1,24 @@
+import type { CardEdgeRuleWidth, CardVariant } from './types';
+/**
+ * The boxless `open` card, as data.
+ *
+ * Every implementation of the role is the same shape — no fill, no box, square
+ * corners, an inline-flush content edge, a full hairline rule across the top
+ * and a short brand accent sitting on it. This absorbed the legacy
+ * `editorial-rule` treatment class, which Phase 3 deleted; the treatment's
+ * bundled `margin-top: 1rem` is deliberately absent, because outer rhythm is
+ * composition, not card identity. Pinned by `openCardVariant.test.ts`.
+ *
+ * What a site style gets to change is the *marking*: which token the accent
+ * uses and how heavy it is. Anna Raven's grounded-practice style takes her
+ * ochre `accent` where the generated baseline takes `primary`.
+ */
+export declare function boxlessOpenCardVariant(marking: Readonly<{
+    /** Token for the short accent rule riding on the hairline. */
+    accentToken: string;
+    accentWidth: CardEdgeRuleWidth;
+    /** Token for the full-width hairline. Defaults to `border`. */
+    ruleToken?: string;
+    /** Opacity for the hairline, when it should sit back from the border colour. */
+    ruleAlpha?: number;
+}>): CardVariant;

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

@@ -0,0 +1,38 @@
+import type { Theme } from '../schema';
+import type { CardRole, CardSystem, CardVariant, SurfaceCardRole } from './types';
+/**
+ * Card role resolution — the closed interface between Looks (which say *which
+ * role*) and site styles (which say *what the role looks like*).
+ *
+ * The fallback chain is total, so a Look never has to know which variants a
+ * site style happens to define.
+ */
+/** Where a resolved surface came from. */
+export type CardSurfaceSource = 'site-style' | 'generated-baseline';
+export type ResolvedCardSurface = {
+    kind: 'none';
+    requestedRole: CardRole;
+} | {
+    kind: 'surface';
+    requestedRole: CardRole;
+    /** The role whose variant actually supplied the surface. */
+    resolvedRole: SurfaceCardRole;
+    variant: CardVariant;
+    source: CardSurfaceSource;
+};
+/**
+ * Resolve a card role against a site style's card system.
+ *
+ * - `none` — terminal, no surface.
+ * - `open` — site style's `open` variant → generated baseline `open`.
+ * - `default` — site style's `default` → generated baseline `default`.
+ * - `alternative` — site style's `alternative` → site style's `default` →
+ *   generated baseline `default`.
+ *
+ * The `theme` argument exists solely so the chain can reach the generated
+ * baseline without the caller synthesizing one. Pass `null` for `cardSystem`
+ * when the site style declares none — resolving against a baseline the caller
+ * synthesized would report `source: 'site-style'` for a surface no site style
+ * chose.
+ */
+export declare function resolveCardRole(theme: Theme, cardSystem: CardSystem | null, role: CardRole): ResolvedCardSurface;

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";