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.
- package/contexts/decisions/rulings.yaml +18 -0
- package/contexts/grammars/contract-sections.md +1 -0
- package/contexts/grammars/contract.md +11 -1
- package/contexts/grammars/contract.yaml +23 -0
- package/contexts/hfs/rules.yaml +7 -0
- package/contexts/project/index.md +9 -7
- package/contexts/stack/pins.yaml +6 -6
- package/contexts/ui/components/README.md +1 -0
- package/contexts/ui/components/backdrop.md +41 -0
- package/contexts/ui/components/card.md +2 -2
- package/contexts/ui/components/mascot.md +2 -2
- package/dist/contexts-search.json +1 -1
- package/package.json +2 -2
|
@@ -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
|
package/contexts/hfs/rules.yaml
CHANGED
|
@@ -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) ·
|
|
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
|
|
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) ·
|
|
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) ·
|
|
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
|
|
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) ·
|
|
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
|
|
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.
|
package/contexts/stack/pins.yaml
CHANGED
|
@@ -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.
|
|
12
|
-
'@starci/eslint-canon-be': {version: 3.9.
|
|
13
|
-
'@starci/eslint-canon-fe': {version: 9.6.
|
|
14
|
-
'@starci/eslint-grammar-core': {version: 0.16.
|
|
15
|
-
'@starci/eslint-grammar-offset-pop': {version: 0.16.
|
|
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.
|
|
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
|
|
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
|
|
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
|
|