starci-harness 1.1.0-alpha.21 → 1.1.0-alpha.22

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -305,6 +305,24 @@ rulings:
305
305
  words: "EmptyNotice có slot artwork"
306
306
  ruling: "EmptyNotice has an artwork slot: generated character art drawn as the Mascot at md and tied to its asset slot, and a first-run empty state uses EmptyNotice with that artwork."
307
307
  owner: "@starci/grammar src/core/composite/EmptyNotice; contexts/ui/components/empty-state.md empty-state.choose.cause"
308
+ - id: accent-corner
309
+ date: '2026-10-30'
310
+ status: live
311
+ words: "Thêm vào grammar"
312
+ ruling: "A one-corner rounding is a grammar prop, never app paint: SurfaceCard and MediaFrame take `accentCorner` (start-start, start-end, end-start or end-end), which draws that one logical corner at the Common accent radius `--grammar-accent-corner` while the other corners keep the family's surface radius. An app's `rounded-br` and its kin give way to it."
313
+ owner: "@starci/grammar src/core/branch/SurfaceCard, src/core/primitive/MediaFrame, src/common/styles.css; contexts/grammars/contract.md Corners are roles; contexts/grammars/contract.yaml DNA-COMMON-ACCENT-CORNER"
314
+ - id: backdrop
315
+ date: '2026-10-30'
316
+ status: live
317
+ words: "à đổi thành component background đi chứ nó cũng không phải là surfacecard, chốt vậy đi; Backdrop + giữ accentCorner"
318
+ ruling: "The brand half of a split screen (a sign-in) is a Backdrop, not a SurfaceCard: the brand's light tint full-bleed in its host, no card anatomy, the brand copy over it and a hero Mascot as its artwork, with one corner through `accentCorner`. SurfaceCard and MediaFrame keep `accentCorner` too."
319
+ owner: "@starci/grammar src/core/composite/Backdrop, src/common/styles.css; contexts/grammars/contract.md Backdrop; contexts/ui/components/backdrop.md"
320
+ - id: workspace-shell-fills-viewport
321
+ date: '2026-10-30'
322
+ status: live
323
+ words: "sao mà background dc nửa màn thôi thế???"
324
+ ruling: "A WorkspaceShell is at least one viewport tall, so the canvas under a short page runs to the bottom of the screen."
325
+ owner: "@starci/grammar src/common/styles.css .starci-core-workspace-shell"
308
326
  - id: STATE-8/loading-keeps-anatomy
309
327
  date: '2026-10-11'
310
328
  status: live
@@ -28,6 +28,7 @@ the whole file and reads a section when it needs it: `starci contexts anchor <an
28
28
  - EmptyState · `contexts/grammars/contract.md#emptystate` · 1 KB — An empty state is a region with nothing to show, or whose read failed: one message in the region's place inside the unchanged surface, and one action only when a real next step ...
29
29
  - Avatar · `contexts/grammars/contract.md#avatar` · 1 KB — An avatar is an identity mark on the ramp (`sm`, `md`, `lg`, and `control` in a bar), so it matches the controls beside it.
30
30
  - Mascot · `contexts/grammars/contract.md#mascot` · 1 KB — A mascot is generated character art on its own size scale, so one character comes out at one size on every screen: square boxes `sm`, `md` and `lg` (Common tokens ...
31
+ - Backdrop · `contexts/grammars/contract.md#backdrop` · 1 KB — A backdrop is the brand's own ground in a split screen: the family's light tint (`accentSoft`), full-bleed in its host, with the brand copy at the top and the artwork (a hero ...
31
32
  - PageHeader · `contexts/grammars/contract.md#pageheader` · 1 KB — The page header is the top of one page: the trail, the page heading (the document's one h1) with the subject's mark, status chips and summary, the page's commands, and the page ...
32
33
  - Page · `contexts/grammars/contract.md#page` · 1 KB — A page is one route's frame: the page header band (PageHeader's slots, given as data) across the region, then the body in the page measure and gutter.
33
34
  - Diagram · `contexts/grammars/contract.md#diagram` · 1 KB — A diagram draws a structure the reader follows: `MermaidDiagram` renders an article's Mermaid source in the grammar's tokens, `FlowGraph` draws nodes and edges the app holds ...
@@ -54,7 +54,10 @@ the box is the ramp, the hit area meets its floor without redrawing the box (`DN
54
54
  three times `radius`, so whether a Button is a pill follows from the grammar's radius, never from a per-button
55
55
  choice. The grammar publishes the corner roles an app may name (`tiny`, `compact`, `control`, `surface`, `hero`,
56
56
  `pill`) as `--grammar-radius-*`, each set from its base radius; an app never writes a literal corner, which would
57
- freeze one grammar's value into every grammar.
57
+ freeze one grammar's value into every grammar. One corner may stand out: a SurfaceCard or MediaFrame names it in
58
+ `accentCorner` (a logical corner, `start-start` to `end-end`), drawn at the Common accent radius
59
+ `--grammar-accent-corner` while the others keep the family's radius (ruling accent-corner); an app never rounds one
60
+ corner itself.
58
61
 
59
62
  ## Intent x placement -> variant
60
63
 
@@ -226,6 +229,13 @@ it. It is decorative unless its `alt` names it. It carries the asset-slot props
226
229
  render is tied to the request that generated it; generated art reaches the page only through `Mascot` or a
227
230
  `MediaFrame` (lint R338, R339). The scale is Common's: a grammar changes nothing about it.
228
231
 
232
+ ### Backdrop
233
+
234
+ A backdrop is the brand's own ground in a split screen: the family's light tint (`accentSoft`), full-bleed in its host,
235
+ with the brand copy at the top and the artwork (a hero `Mascot`) filling the height left. It is a ground, not a card:
236
+ no border, no shadow, no card inset, and square corners except the one `accentCorner` names (ruling backdrop). A brand
237
+ moment among other content stays a soft `SurfaceCard`.
238
+
229
239
  ### PageHeader
230
240
 
231
241
  The page header is the top of one page: the trail, the page heading (the document's one h1) with the subject's mark,
@@ -125,6 +125,7 @@ roles:
125
125
  states: [neutral, pending, PresentationState]
126
126
  grammarMayChange: [surface paint, edge (border/shadow by depth), radius via surfaceRadius, label placement inside or outside the material, the ink ground and its inks]
127
127
  dna: [DNA-COMMON-NO-RAISED-SURFACE-IN-SURFACE, DNA-COMMON-CARD-LABEL-ABOVE, DNA-COMMON-CARD-LABEL-HEADING, DNA-COMMON-LISTCARD-LABEL-OUTSIDE, DNA-COMMON-LISTCARD-LABEL-UNPAINTED, DNA-COMMON-ONE-HIGHLIGHT, DNA-COMMON-DIVIDER-FULL-BLEED, DNA-COMMON-SOFT-GROUND, DNA-COMMON-TREATMENT-TEXT-CONTRAST, DNA-CORE-EDGE-TOP, DNA-CORE-EDGE-NESTED, DNA-CORE-CARD-LABEL-OUTSIDE, DNA-OFFSET-POP-STICKER, DNA-OFFSET-POP-POCKET, DNA-OFFSET-POP-CARD-LABEL-OUTSIDE]
128
+ lint: [starci-grammar/no-raised-surface-in-surface]
128
129
 
129
130
  - id: button
130
131
  ui: ui/components/button.md
@@ -328,6 +329,18 @@ roles:
328
329
  states: ["loading (transparent, no plate)", loaded, "error (the Image's fallback)"]
329
330
  grammarMayChange: ["nothing: fit contain, the transparent ground with no plate, and the scale are Common's"]
330
331
  dna: []
332
+
333
+ - id: backdrop
334
+ ui: ui/components/backdrop.md
335
+ renderers: [Backdrop]
336
+ vendorParity: [] # no HeroUI part: a Common region
337
+ slots: ["children: the brand copy (logo, heading, tagline)", "artwork: decorative, usually a hero Mascot"]
338
+ variants:
339
+ accentCorner: { values: [start-start, start-end, end-start, end-end], chosenBy: app, meaning: "that one logical corner at --grammar-accent-corner; the others square" }
340
+ sizes: { fills: "its host's block size" }
341
+ states: []
342
+ grammarMayChange: ["nothing: the tint is the family's accentSoft, the inset and the accent radius are Common's"]
343
+ dna: [DNA-COMMON-BACKDROP-GROUND, DNA-COMMON-ACCENT-CORNER]
331
344
  lint: [starci-grammar/generated-art-in-mascot-or-media-frame, starci-grammar/mascot-asset-slot-required]
332
345
 
333
346
  - id: shell
@@ -643,6 +656,16 @@ mustKeep:
643
656
  - { select: '[data-grammar-surface-treatment] [data-component="Stepper"] [data-grammar-step-marker]' }
644
657
  - { select: '[data-grammar-surface-treatment] :is([data-component="Text"], [data-grammar-section-header] :is(h2, h3, p))' }
645
658
  owner: surfacecard-soft-treatment; COLOR-5; story Navigation & Data / Stepper on every treatment, Surfaces / Soft surface card
659
+ - id: DNA-COMMON-ACCENT-CORNER
660
+ role: card
661
+ law: The corner a SurfaceCard or MediaFrame names in accentCorner is drawn at the Common accent radius.
662
+ measure: { kind: style, select: '[data-grammar-accent-corner="end-end"]', metric: border-end-end-radius, op: "=", value: { token: --grammar-accent-corner } }
663
+ owner: accent-corner
664
+ - id: DNA-COMMON-BACKDROP-GROUND
665
+ role: backdrop
666
+ law: A Backdrop's ground is the family's accent-soft tint, with no border and no shadow.
667
+ measure: { kind: style, select: '[data-component="Backdrop"]', metric: background-color, op: "=", value: { token: --accent-soft } }
668
+ owner: backdrop
646
669
  # --- lists
647
670
  - id: DNA-COMMON-LIST-SEAMS
648
671
  role: list
@@ -2301,6 +2301,13 @@ rules:
2301
2301
  - FE_MASCOT_ASSET_SLOT_MISSING
2302
2302
  enforcers:
2303
2303
  - {kind: eslint-grammar-core, id: mascot-asset-slot-required}
2304
+ - id: R340
2305
+ code: FE_RAISED_SURFACE_IN_SURFACE
2306
+ law: A Grammar surface that accepts a depth prop (SurfaceListCard) does not pass depth="top" when a SurfaceCard, SurfaceListCard or SurfaceAccordionCard of the same file encloses it; a nested surface is subordinate (outlined, BOUNDARY-5), never raised again (BOUNDARY-6, DNA-COMMON-NO-RAISED-SURFACE-IN-SURFACE), and the Grammar resolves the depth from the surface context. A depth computed at run time is not judged.
2307
+ failureCodes:
2308
+ - FE_RAISED_SURFACE_IN_SURFACE
2309
+ enforcers:
2310
+ - {kind: eslint-grammar-core, id: no-raised-surface-in-surface}
2304
2311
 
2305
2312
  # Owner section. The gaps `starci contexts anatomy` (its dry run) takes as pending instead of red: a slot rule code no rule carries
2306
2313
  # (slot-rule-unknown), a rule with no enforcer (rule-no-enforcer) or only planned ones (rule-enforcer-planned). Each entry is
@@ -151,16 +151,16 @@ reads this index instead of the whole tree, then opens only the files its tasks
151
151
  - [decisions/open-grammar.md](../decisions/open-grammar.md) · 16 KB — Decisions taken while writing grammars and vendor, each with the alternative and the reason, so the owner can overturn one in one place.
152
152
  - sections: Decisions · offset-pop, designed on the contract · Code follow-ups named by the grammar files · Gaps: choices an app can make two ways · What the contract cannot express yet · Wrappers pin
153
153
  - [decisions/open-ui.md](../decisions/open-ui.md) · 7 KB — Choices made while writing `contexts/ui`, each awaiting the owner's feedback.
154
- - [decisions/rulings.yaml](../decisions/rulings.yaml) · 55 KB — The one log of owner rulings that knowledge, the grammar package, the canon lint and the policy exceptions carry.
155
- - ids: COLLECTION-1/case-8, CTA-1/case-5, CTA-1/case-6, CTA-1/case-7, CTA-4/case-5, FOCUS-1/case-6, LAYOUT-1/case-8, LAYOUT-1/case-9, R212, R212/case-10, R212/case-4, R212/case-7, R212/case-9, R318/case-1, RESPONSIVE-1/case-6, STATE-6/case-5, STATE-6/case-6, STATE-8/loading-keeps-anatomy, agent-avatar-initials-bot-badge, alert-white-surface, app-owned-schedules, app-secrets-one-standard, auth-callback-shape, avatar-default-dicebear-initials and 96 more
154
+ - [decisions/rulings.yaml](../decisions/rulings.yaml) · 57 KB — The one log of owner rulings that knowledge, the grammar package, the canon lint and the policy exceptions carry.
155
+ - ids: COLLECTION-1/case-8, CTA-1/case-5, CTA-1/case-6, CTA-1/case-7, CTA-4/case-5, FOCUS-1/case-6, LAYOUT-1/case-8, LAYOUT-1/case-9, R212, R212/case-10, R212/case-4, R212/case-7, R212/case-9, R318/case-1, RESPONSIVE-1/case-6, STATE-6/case-5, STATE-6/case-6, STATE-8/loading-keeps-anatomy, accent-corner, agent-avatar-initials-bot-badge, alert-white-surface, app-owned-schedules, app-secrets-one-standard, auth-callback-shape and 99 more
156
156
  - [grammars/README.md](../grammars/README.md) · 10 KB — A grammar is the visual language an app's UI is drawn in.
157
157
  - sections: Three layers · The model: one contract, composed implementations · Files · Who owns what · Reading order for an author · Where feedback lands
158
158
  - [grammars/common.md](../grammars/common.md) · 10 KB — Common is the layer every grammar is drawn over.
159
159
  - sections: Anatomy: wrap HeroUI once, never redraw it · Spacing: one scale, four relationships · Size and intent · One root · Idioms · Playbook shapes
160
- - [grammars/contract.md](../grammars/contract.md) · 18 KB — Every grammar implements one contract, so a new grammar can be added without touching the others and two apps on the same grammar come out the same.
160
+ - [grammars/contract.md](../grammars/contract.md) · 19 KB — Every grammar implements one contract, so a new grammar can be added without touching the others and two apps on the same grammar come out the same.
161
161
  - sections: What a grammar provides · The shared scale · Intent x placement -> variant · Roles
162
- - [grammars/contract.yaml](../grammars/contract.yaml) · 77 KB — What every grammar implements.
163
- - ids: DNA-<SCOPE>-<NAME>,, DNA-COMMON-AGENT-NAMED, DNA-COMMON-ALERT-SURFACE, DNA-COMMON-ALERTDIALOG-DISMISS-FIRST, DNA-COMMON-AVATAR-GROUP-ONE-SIZE, DNA-COMMON-AVATAR-INITIALS, DNA-COMMON-AVATAR-RAMP, DNA-COMMON-BADGE-BELOW-RAMP, DNA-COMMON-BAR-ONE-HEIGHT, DNA-COMMON-BUTTONGROUP-INNER-CORNERS, DNA-COMMON-BUTTONGROUP-JOINED, DNA-COMMON-BUTTONGROUP-NO-PRESS-SCALE, DNA-COMMON-BUTTONGROUP-ONE-INTENT, DNA-COMMON-CARD-LABEL-ABOVE, DNA-COMMON-CARD-LABEL-HEADING, DNA-COMMON-CHIP-LABEL-UPPERCASE, DNA-COMMON-CHIP-NOT-TARGET, DNA-COMMON-CONTROL-FILL, DNA-COMMON-CONTROL-LG, DNA-COMMON-CONTROL-MD, DNA-COMMON-CONTROL-SM, DNA-COMMON-COPYFIELD-MASKED, DNA-COMMON-COPYFIELD-TAIL, DNA-COMMON-DIAGRAM-ERROR-SOURCE and 115 more
162
+ - [grammars/contract.yaml](../grammars/contract.yaml) · 78 KB — What every grammar implements.
163
+ - ids: DNA-<SCOPE>-<NAME>,, DNA-COMMON-ACCENT-CORNER, DNA-COMMON-AGENT-NAMED, DNA-COMMON-ALERT-SURFACE, DNA-COMMON-ALERTDIALOG-DISMISS-FIRST, DNA-COMMON-AVATAR-GROUP-ONE-SIZE, DNA-COMMON-AVATAR-INITIALS, DNA-COMMON-AVATAR-RAMP, DNA-COMMON-BACKDROP-GROUND, DNA-COMMON-BADGE-BELOW-RAMP, DNA-COMMON-BAR-ONE-HEIGHT, DNA-COMMON-BUTTONGROUP-INNER-CORNERS, DNA-COMMON-BUTTONGROUP-JOINED, DNA-COMMON-BUTTONGROUP-NO-PRESS-SCALE, DNA-COMMON-BUTTONGROUP-ONE-INTENT, DNA-COMMON-CARD-LABEL-ABOVE, DNA-COMMON-CARD-LABEL-HEADING, DNA-COMMON-CHIP-LABEL-UPPERCASE, DNA-COMMON-CHIP-NOT-TARGET, DNA-COMMON-CONTROL-FILL, DNA-COMMON-CONTROL-LG, DNA-COMMON-CONTROL-MD, DNA-COMMON-CONTROL-SM, DNA-COMMON-COPYFIELD-MASKED and 118 more
164
164
  - [grammars/core.md](../grammars/core.md) · 6 KB — `core` is the product and workspace grammar: a quiet neutral page, white surfaces, one violet accent.
165
165
  - sections: Material and why · How core fills the contract · Departures · Lint
166
166
  - [grammars/offset-pop.md](../grammars/offset-pop.md) · 7 KB — `offset-pop` is the playful, mobile-first grammar for consumer and learning apps: a cream canvas, objects drawn like stickers (an ink outline and a hard offset shadow), one pink ...
@@ -178,8 +178,8 @@ reads this index instead of the whole tree, then opens only the files its tasks
178
178
  - sections: One word, one meaning: "slot" · Slot fields · Rule parameters (`ruleParams`) · Rules · The harness's own shape · Editing
179
179
  - [hfs/harness.yaml](../hfs/harness.yaml) · 17 KB — The harness repository's own HFS: what may exist in this repository (hfs.json kind runtime) and where.
180
180
  - ids: app.package, app.tree, cli.edition-verbs, cli.entry, cli.harness, cli.package, cli.shared, cli.verb-data, cli.verbs, contexts.harness-shape, contexts.knowledge, contexts.load-order, github.actions, github.ci, github.meta, github.scripts, github.workflows, never.build-output, never.cli-js, never.env, never.examples, never.grammar-tests, never.knowledge-outside-contexts, never.package-js and 32 more
181
- - [hfs/rules.yaml](../hfs/rules.yaml) · 101 KB — The HFS rule catalog: one entry per rule, its finding code, its law in one sentence, the failure codes it reports and the enforcers that judge it.
182
- - ids: R01, R02, R03, R04, R05, R06, R10, R100, R101, R102, R103, R104, R105, R106, R107, R108, R109, R11, R110, R111, R112, R113, R12, R13 and 235 more
181
+ - [hfs/rules.yaml](../hfs/rules.yaml) · 102 KB — The HFS rule catalog: one entry per rule, its finding code, its law in one sentence, the failure codes it reports and the enforcers that judge it.
182
+ - ids: R01, R02, R03, R04, R05, R06, R10, R100, R101, R102, R103, R104, R105, R106, R107, R108, R109, R11, R110, R111, R112, R113, R12, R13 and 236 more
183
183
  - [hfs/slots.yaml](../hfs/slots.yaml) · 97 KB — The HFS slot manifest: what may exist in an app repository and where.
184
184
  - ids: app.agent-output, app.browser, app.browser-config, app.build-output, app.ci, app.ci-authorize-deploy-key, app.ci-db, app.ci-deploy, app.ci-e2e, app.ci-images, app.ci-stack-deploy, app.ci-stack-key-restore, app.db, app.db.bootstrap, app.db.image, app.db.migrations, app.db.migrations.archive, app.db.seed, app.declaration, app.dependabot, app.deploy, app.dockerignore, app.format-config, app.git-meta and 131 more
185
185
  - [project/README.md](../project/README.md) · 7 KB — What a StarCi project is, how a piece of product work travels from a record to a settled commit, and where to read for each kind of task.
@@ -207,6 +207,8 @@ reads this index instead of the whole tree, then opens only the files its tasks
207
207
  - sections: The Choose format · Choosing a role
208
208
  - [ui/components/action-group.md](../ui/components/action-group.md) · 3 KB — Contract: ButtonGroup.
209
209
  - sections: Job · Choose · Variants · Size · States · Owner split · Rules
210
+ - [ui/components/backdrop.md](../ui/components/backdrop.md) · 2 KB — Contract: Backdrop.
211
+ - sections: Job · Choose · Variants · Size · States · Owner split · Rules
210
212
  - [ui/components/button.md](../ui/components/button.md) · 5 KB — Contract: Button.
211
213
  - sections: Job · Choose · Variants · Size · States · Owner split · Rules
212
214
  - [ui/components/card.md](../ui/components/card.md) · 4 KB — Contract: Card.
@@ -8,18 +8,18 @@ schema: starci/stack-pins@1
8
8
  pins:
9
9
  '@starci/heroicons': {version: 0.3.5, group: starci, side: fe, install: registry, why: "the extension glyph set: only the meanings @heroicons/react lacks, drawn in its style"}
10
10
  '@starci/event-stream': {version: 0.1.0, group: starci, side: fe, install: registry, why: "the one server-sent-events client; apps create one instance in modules/api/sse/clients"}
11
- '@starci/grammar': {version: 0.16.0, group: starci, side: fe, install: registry, why: "the grammar package an app composes (grammars core and offset-pop)"}
12
- '@starci/eslint-canon-be': {version: 3.9.0, group: starci, side: be, install: registry, why: "the back-end ESLint canon"}
13
- '@starci/eslint-canon-fe': {version: 9.6.0, group: starci, side: fe, install: registry, why: "the universal front-end ESLint canon"}
14
- '@starci/eslint-grammar-core': {version: 0.16.0, group: starci, side: fe, install: registry, why: "the core grammar's lint factory, holding the grammar API checks every grammar inherits (open-grammar D-7); versioned with the grammar"}
15
- '@starci/eslint-grammar-offset-pop': {version: 0.16.0, group: starci, side: fe, install: registry, why: "the offset-pop grammar's lint factory; versioned with the grammar"}
11
+ '@starci/grammar': {version: 0.16.2, group: starci, side: fe, install: registry, why: "the grammar package an app composes (grammars core and offset-pop)"}
12
+ '@starci/eslint-canon-be': {version: 3.9.2, group: starci, side: be, install: registry, why: "the back-end ESLint canon"}
13
+ '@starci/eslint-canon-fe': {version: 9.6.2, group: starci, side: fe, install: registry, why: "the universal front-end ESLint canon"}
14
+ '@starci/eslint-grammar-core': {version: 0.16.2, group: starci, side: fe, install: registry, why: "the core grammar's lint factory, holding the grammar API checks every grammar inherits (open-grammar D-7); versioned with the grammar"}
15
+ '@starci/eslint-grammar-offset-pop': {version: 0.16.2, group: starci, side: fe, install: registry, why: "the offset-pop grammar's lint factory; versioned with the grammar"}
16
16
  '@starci/stylelint-canon': {version: 2.2.1, group: starci, side: fe, install: registry, why: "the front-end stylelint canon"}
17
17
  '@starci/tsconfig': {version: 2.1.0, group: starci, side: both, install: registry}
18
18
  '@starci/prettier-config': {version: 1.1.0, group: starci, side: both, install: registry}
19
19
  '@starci/jest-preset': {version: 2.5.3, group: starci, side: be, install: registry, why: "the back-end Jest preset; pairs exactly with @starci/test-world"}
20
20
  '@starci/test-world': {version: 1.3.3, group: starci, side: be, install: registry, why: "the back-end e2e world; pairs exactly with @starci/jest-preset"}
21
21
  '@starci/ai-router': {version: 0.4.1, group: starci, side: be, install: registry, why: "the AI pool router module of a back end; jest-preset compiles it as ESM"}
22
- '@starci/hfs': {version: 4.12.0, group: starci, side: both, install: registry, why: "the app implementation starci-harness runs for starci app"}
22
+ '@starci/hfs': {version: 4.12.2, group: starci, side: both, install: registry, why: "the app implementation starci-harness runs for starci app"}
23
23
  '@langchain/core': {version: 1.3.1, group: framework, side: be, why: "the LangChain core of the one AI integration (contexts/code/be/ai.md)"}
24
24
  '@langchain/openai': {version: 1.8.0, group: framework, side: be, why: "ChatOpenAI and OpenAIEmbeddings of the one AI integration, pointed at the ai-router gateway"}
25
25
  typescript: {version: 5.9.3, group: tooling, side: both}
@@ -73,4 +73,5 @@ This table only routes a need to the page whose own Choose tables decide; it is
73
73
  | a region with nothing in it yet, or a failed region | [empty-state](empty-state.md) |
74
74
  | a compact identity beside a name | [identity-mark](identity-mark.md) |
75
75
  | show the product's generated character (mascot) art | [mascot](mascot.md) |
76
+ | give the brand its own tinted ground in a split screen (a sign-in brand half) | [backdrop](backdrop.md) |
76
77
  | draw a diagram: an article's Mermaid source, or nodes and edges the app holds | [diagram](diagram.md) |
@@ -0,0 +1,41 @@
1
+ # Backdrop
2
+
3
+ Contract: [Backdrop](../../grammars/contract.md#backdrop). Vendor: none (a Common region).
4
+
5
+ ## Job
6
+ Give the brand its own ground in a split screen: the brand's light tint, full-bleed in its host, carrying the brand copy
7
+ and the character art, with no card around it.
8
+
9
+ ## Choose
10
+
11
+ Choice `backdrop.choose.ground`: what carries a brand moment.
12
+
13
+ | Row | When | Choose | Measure |
14
+ | --- | --- | --- | --- |
15
+ | split | a split screen gives the brand its own half or column (a sign-in or sign-up split) | `Backdrop` filling that half, the copy as children, the hero `Mascot` as `artwork` | judgement |
16
+ | card | the brand moment holds a task's copy or controls among other content (a first-run welcome) | a `SurfaceCard` `treatment="soft"` with `artwork` ([card](card.md)) | judgement |
17
+
18
+ Choice `backdrop.choose.corner`: whether one corner stands out.
19
+
20
+ | Row | When | Choose | Measure |
21
+ | --- | --- | --- | --- |
22
+ | accent | the brand record draws the backdrop with one rounded corner (the corner toward the task half) | `accentCorner` naming that logical corner | judgement |
23
+ | square | otherwise | no `accentCorner` | judgement |
24
+
25
+ ## Variants
26
+ The ground is always the brand's light tint; the app chooses only the accent corner, the copy and the art.
27
+
28
+ ## Size
29
+ It fills its host (block size 100%); the copy sits at the top at the page inset and the artwork takes the height left,
30
+ so a hero `Mascot` fills it.
31
+
32
+ ## States
33
+ None of its own; the art keeps the Mascot's states.
34
+
35
+ ## Owner split
36
+ - **Grammar owns:** the tint, the inset, the copy and artwork zones, the accent radius `--grammar-accent-corner`.
37
+ - **Knowledge decides:** backdrop vs soft card (the table above); the mascot's place within DISCIPLINE-3.
38
+ - **App author decides:** the host region, the corner, the brand copy, the art's asset slot.
39
+
40
+ ## Rules
41
+ BRAND-2, DISCIPLINE-3; ruling backdrop, ruling accent-corner; lint R338 and R339 on its art.
@@ -49,10 +49,10 @@ No size. Width follows measure rules; a form card caps itself with the surface's
49
49
  Loading renders the same card in skeleton mode; a failed card fails in place (STATE-8).
50
50
 
51
51
  ## Owner split
52
- - **Grammar owns:** face, corner, elevation by depth, inset, band and joined composition, highlight, form measure.
52
+ - **Grammar owns:** face, corner (one accent corner through `accentCorner`, ruling accent-corner), elevation by depth, inset, band and joined composition, highlight, form measure.
53
53
  - **Knowledge decides:** card vs section, bands vs inner cards, hairline budget, nesting depth.
54
54
  - **App author decides:** the subject, its content, the label.
55
55
 
56
56
  ## Rules
57
57
  COLLECTION-1, COLLECTION-2, DISCIPLINE-1 (`budgets.hairlinesPerCard`), BOUNDARY-1..6, SURFACE-2..6. Lint:
58
- `starci-fe/no-app-surface-paint`, `divider-full-bleed`. Proof: TASTE-7 (`budgets.cardDepth`).
58
+ `starci-fe/no-app-surface-paint`, `divider-full-bleed`, `starci-grammar/no-raised-surface-in-surface` (R340). Proof: TASTE-7 (`budgets.cardDepth`).
@@ -12,7 +12,7 @@ Choice `mascot.choose.size`: which step the character takes. The first row that
12
12
  | Row | When | Choose | Measure |
13
13
  | --- | --- | --- | --- |
14
14
  | wizard | a step of the app's first-run wizard, beside or above its form (DISCIPLINE-3) | `md`, or `sm` when the step's form fills the region; never over a field, an error or an action | judgement |
15
- | split | a split screen gives the art its own half (a sign-in split) | `hero`, `visibility` `wide` unless the art carries meaning the compact layout needs (`always`) | judgement |
15
+ | split | a split screen gives the art its own half (a sign-in split) | `hero` in the `artwork` of the `Backdrop` that fills that half, `visibility` `wide` unless the art carries meaning the compact layout needs (`always`) | judgement |
16
16
  | lead | the art leads a one-task region with no form: a welcome, a finished task | `lg` | judgement |
17
17
  | support | the art accompanies a message inside a region: a first-run empty state (`EmptyNotice` `artwork`, drawn at this step by the grammar), a notice | `md` | judgement |
18
18
  | inline | the art sits beside a line or a compact row | `sm` | judgement |
@@ -40,7 +40,7 @@ Loading keeps the box transparent (no plate); a failed load keeps the box.
40
40
  visibility, the `data-asset-*` attributes.
41
41
  - **Knowledge decides:** the step and whether the art is named (the tables above); where a mascot may appear is the
42
42
  brand record's within DISCIPLINE-3 (never on an error, a table, a loading state or a form other than a first-run
43
- wizard step), and its carriers are a `Mascot`, the artwork slot of a soft or ink `SurfaceCard`, or a first-run
43
+ wizard step), and its carriers are a `Mascot`, the artwork slot of a soft or ink `SurfaceCard` or of a `Backdrop`, or a first-run
44
44
  `EmptyNotice`'s `artwork`.
45
45
  - **App author decides:** the asset slot and its delivered file, the step by the table, `alt` copy.
46
46