@usableapp/cardds 0.7.98 → 0.7.99

package/docs/reference.md

@@ -575,6 +575,12 @@ between at 40% down the screen (see *Anatomy*, "Where the centre is"):
   them. Seen in timebank's help-ask prototype: a Composer, a Dropdown and a
   map on white cards inside the help sheet, the cards the colour of the
   ground.
+  `field-off-sheet` (error) flags the same controls when their nearest
+  container in the file is a `Page`, `Pages`, `Step` or `Screen`: a form is
+  never on the ground. A form over a screen is a `Sheet` in a
+  `SheetStage over dim` (gallery `Home/AskSheet`). A bar's control is not a
+  form on the ground: a `Slider` in an `ActionBarTier`, a `Dropdown` in a
+  `FilterRow` or a `TopBar`'s actions, a `Toggle` in an `AppBar`.
 - **Two sheet systems, one material.** *Sheet single* (`.sheet`, `sheet.css`)
   is ONE sheet the member acts in, whatever it holds: a short entry in front
   of a step's card, a place on a map, a payment on a dim page — in a `.step`

package/lint/rules.mjs

@@ -233,11 +233,23 @@ export function checkSource(source, file, { classes = carddsClasses() } = {}) {
   const stacks = span(/<SheetStack\b(?![\w.])/g), cards = span(/<Card\b(?![\w.])/g);
   const within = (at, el) => at > el.at && at < el.end;
   const innermost = (at) => cards.filter((c) => within(at, c)).at(-1);
+  // a form is never on the ground (Lh 2026-10-18, timebank's ask steps on a bare Page): the control's nearest container written in this file decides.
+  // None in the file (a step component's fragment) is not judged here — the file that places it is
+  const places = [
+    ...span(/<(?:Sheet|SheetBody|SheetStep|StackSheet|SheetStack)\b(?![\w.])/g).map((p) => ({ ...p, ground: false })),
+    ...span(/<(?:ActionBarTier|FilterRow|TopBar|AppBar)\b(?![\w.])/g).map((p) => ({ ...p, ground: false })), // a bar's control: a Slider in a control tier, a Dropdown in a filter row or a top bar's actions, a Toggle in an app bar
+    ...span(/<(?:Page|Pages|Step|Screen)\b(?![\w.])/g).map((p) => ({ ...p, ground: true })),
+    ...cards.map((p) => ({ ...p, ground: false })), // a card round it is field-in-card's finding
+  ].sort((a, b) => a.at - b.at);
+  const onGround = (at) => places.filter((p) => within(at, p)).at(-1)?.ground;
   for (const c of text.matchAll(/<(Field|Composer|ComposerArea|Pin|Dropdown|Slider|Toggle|Check|ChipPick|Calendar|DayStrip|Day|Picker|Mood|AvatarPick|FileBtn|AddRow|MapPick|Tile)\b(?![\w.])/g)) {
     const kind = c[1] === 'Tile' ? tagAt(text, c.index).match(/\s(pick|upload)\b(?!\s*=\s*\{\s*false)/)?.[1] : null;
     if (c[1] === 'Tile' && !kind) continue; // a plain or stat Tile is read, not filled
     const card = innermost(c.index);
-    if (!card) continue;
+    if (!card) {
+      if (onGround(c.index)) add('field-off-sheet', 'error', c.index, `<${kind ? `Tile ${kind}` : c[1]}> on the ground: a form is never on the ground, it sits only on a sheet (Lh 2026-10-18). A Page, Pages, Step or Screen is the base, not a sheet. Put the control on a Sheet's <SheetBody>, in a <SheetStep>, or on a stack sheet — a form over a screen is a <Sheet> in a <SheetStage over dim> (Home/AskSheet).`);
+      continue;
+    }
     const stack = stacks.filter((s) => card.at >= s.body && card.at < s.end).at(-1);
     if (stack && !cards.some((o) => o !== card && within(card.at, o) && o.at >= stack.body)) continue;
     const name = kind ? `Tile ${kind}` : c[1];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usableapp/cardds",
-  "version": "0.7.98",
+  "version": "0.7.99",
   "license": "UNLICENSED",
   "type": "module",
   "description": "card-first mobile design system, React-first: the components in src/ are thin wrappers over the CSS contract (css/*.css stays the only truth); gallery/ shows every story live (npm run dev), tests/ measures the geometry.",