| Reference | Value |
|---|---|
| Subject and boundary | The architecture decisions that shape the packages and the boundaries a contributor or consumer must plan around. |
| Verified source | DECISIONS.md, README principles and the source paths named below, at tag v0.40.0. Verified tag v0.40.0, commit 43bba26a73dd0f7aa01cb7c8f37d697734b367ad, checked 2026-11-10; earlier passes checked 2026-11-09 and November 7, 2026. |
| Support state | Supported decisions and boundaries in published v0.40.0. Product adoption and runtime acceptance belong to the products. |
The architecture decisions live in DECISIONS.md, their only record; this page does not repeat them.
| Policy | Current decision and consequence | Source |
|---|---|---|
| Lockfile acceptance | Generate with pinned Bun locally; Linux frozen CI decides. Regenerate on Linux only when that install requires a lockfile change, inspect the diff and rerun. | CONTRIBUTING.md |
| Motion capability | One pointer gate includes secondary mice on touch devices. pressBounce runs only on touch-only devices, excluding boop. Motion tiers apply; Lenis uses its own policy. Changes apply at mount time. |
motion policy |
| Station tabs | Shared opt-in CSS owns one signage look; products own routing and strip interactions. Hover keeps full ink with a 3px bottom rule, and active weight defaults to 700. | station-tabs.css |
| Sheet and DetailFrame | UI base CSS owns Sheet animation styles. Visible close controls require caller copy. DetailFrame accepts both mobile-pill labels or neither; tracking survives an omitted pill. | UI README |
| Public API | Each package's export map and API report define its public surface. Compatibility gates and owner-approved exceptions apply to the contracts specified in the lifecycle documentation. | DEPRECATION.md and migration documentation |
| Release rehearsal | API-report or migration-note changes require the same rc.N candidate in a draft adoption PR in each of Transit, yesid.dev and yesid.login before stable promotion; the same PR then switches to stable and merges. Owner report approval precedes candidate tagging; changed reports need renewed approval. Gallery does not accept any product. | RELEASING.md |
| App support | Apps target SvelteKit >=3 <4 with TypeScript >=6 <7, Svelte >=5.57.1 and Node >=22.17. Library config accepts TypeScript >=5.9 <7. | config README |
The bulk control's label follows the mounted sections: Expand all when every content section is closed, Collapse all otherwise. With no stored choice, or a malformed one, content starts expanded and the control is neutral, labelled Collapse all. A stored Collapse all collapses content across pages and visits and makes the control active and orange; expanded content clears that active state. activeEffect defaults to glow, with explicit none supported. The storage value is origin-local and applies across visits; malformed values use the expanded first-visit default without rewriting storage. Updates from another tab apply to future mounts without forcing a bulk action on mounted content. Individual choices are preserved when a mount crosses the two-section threshold.
The head script applies geometry before paint and hydration adopts it. Server bodies are complete, open and readable, including declared-closed content. JavaScript-disabled reading stays available. Boot exceptions and failed same-origin /_app/ module scripts or modulepreloads expose pending bodies; optional and cross-origin script failures keep the stored choice; a five-second recovery handles startup stalls. Those pending cards hydrate open, and future mounts adopt the stored choice. Recovery reserves the inactive control's layout space while keeping it hidden and disabled. Pending trigger/body semantics and the bulk accessible name match the visible state.
The pre-paint eligibility scanner has known counting limits in template, scripting-enabled noscript, iframe, xmp, double-escaped script text and comments ending in --!>. Client registration owns the mounted count. The UI components, class merging and shell describe the source behavior and limits; remembered-sections.md defines consumer integration and verification.
| Boundary | What it means |
|---|---|
| No registry publication | Packages exist only as GitHub Release tarballs; installation needs access to GitHub release assets. |
| Only the latest stable release is supported | Security and defect fixes are available in the latest stable release. Consumers receive them by adopting that release. |
| Source-shipped packages | Consumers follow the product guide's ssr.noExternal list and Tailwind source scan. Node-native build files cannot import installed TypeScript directly. |
@yesid/config has no API report |
Its compatibility is guarded by repository contract tests and the documented support ranges. |
| No Figma synchronization | Token generation produces CSS, the Tailwind theme, motion TypeScript and DESIGN.md only. No Figma variable export or round-trip check exists. |
| Gallery evidence is repository evidence | Gallery installs workspace packages, not the released tarballs, and runs Chromium only. Product behavior, locale, accessibility and deployment require product checks. |
| No pre-commit guard | Generated-output drift is caught by ci:tokens and CI, not locally on commit. |
| CI runs on pull requests, merge groups and manual dispatch | Pull requests merge through the main merge queue, which reruns ci. The ci workflow does not run on pushes to main; secret scanning does. |
| Windows lockfile resolution | Make dependency changes with the pinned Bun on your machine. CI's Linux bun install --frozen-lockfile decides; if it fails because the lockfile needs to change, regenerate with the same Bun on Linux and review the diff. |
| Gate walk race | Filesystem gates cannot protect against a tree rewritten while the caller reads returned paths. |
| Analytics delivery | Fire-and-forget; monitoring is the product's job. |
| SvelteKit 3 params | src/params.ts cannot import i18n-core TypeScript because Kit 3 loads it natively with Node. |
| Pending deprecations | @yesid/config/tsconfig/base.json and @yesid/config/turbo/base.json are available deprecated contracts governed by DEPRECATION.md. |