@klodd/ds 5.4.1 → 5.4.3

package/README.md

@@ -1,7 +1,9 @@
 # @klodd/ds
 
+Senast audit: 2026-05-20. Aktiv åtgärdslista: `audits/00-summary.md`.
+
 Klodd Design System - delade tokens, typografi och komponenter for
-Klodds appar (Jubb, Ekonom och framtida).
+Klodds appar (Jubb och Ekonom).
 
 Dark-mode-first PWA-designsystem byggt pa Radix Colors. OKLCH-baserade
 fargramper, pixel-numerisk spacing-konvention och tre-lagers token-
@@ -62,7 +64,7 @@ Officiella **Radix Colors** dark-skalor:
 - **Mauve Dark** (neutral) - lila-tonad gra som kompletterar Blue och Plum
 - **Blue Dark** (Jubb accent) - sky-blue (#0090ff)
 - **Plum Dark** (Ekonom accent) - varm magenta-lila (#ab4aba)
-- **Violet Dark** - bevarad for framtida appar
+- **Violet Dark** - definierad men oanvänd
 - **Green/Amber/Red Dark** - status (success/warning/danger)
 
 Status-tokens har bade solid-bakgrund (`--bg-success/warning/danger`)

package/SKILL.md

@@ -1,14 +1,21 @@
 ---
 name: klodd-ds
-description: Design memory for the @klodd/ds shared design system across all Klodd apps (Jubb, Ekonom, future apps). Use this skill whenever working on UI components, design tokens, theming, CSS class names, spacing, color, typography, accessibility, or any visual or interaction decision in an app that imports @klodd/ds. Also use when questions arise about component APIs, token architecture, BEM naming, whether to add new tokens vs reuse existing, or how to theme a new app. Contains locked architectural decisions (do not re-litigate without explicit instruction) and open migration items (still under discussion).
+description: Design memory for the @klodd/ds shared design system used by the two apps that consume it (Jubb, Ekonom). Use this skill whenever working on UI components, design tokens, theming, CSS class names, spacing, color, typography, accessibility, or any visual or interaction decision in an app that imports @klodd/ds. Also use when questions arise about component APIs, token architecture, BEM naming, or whether to add new tokens vs reuse existing. Contains locked architectural decisions (do not re-litigate without explicit instruction) and open migration items (still under discussion).
 ---
 
 # @klodd/ds — Design Memory
 
+## Status
+Senast audit: 2026-05-20. Pågående arbete enligt `audits/00-summary.md`:
+- Sprint 1: dead-code-städning + topbar-bump (~435 rader)
+- Sprint 2: component-token-konsolidering, ADR 0024-backfill, light-theme-removal
+- Sprint 3: base.css-extraktion till paketets base-lager
+
 ## Vad detta är
 Gemensamt designsystem på npm (`@klodd/ds@5.x`). Tre-lagers tokens,
 38+ komponenter (progress-bar tillagd v5.2.1, 2026-05-18), konsumeras
-av Jubb och Ekonom. Fler appar planerade.
+av Jubb och Ekonom - det är paketets hela scope, inte ett paraply för
+fler appar.
 Denna Skill fångar både reglerna ("vad") och resonemanget ("varför").
 
 ## Läs i denna ordning
@@ -28,15 +35,15 @@ Denna Skill fångar både reglerna ("vad") och resonemanget ("varför").
 </locked_rules>
 
 ## Apps och theming
+@klodd/ds har exakt två konsumenter - Jubb och Ekonom. Det finns inget
+mönster för att introducera fler appar; theming-modellen är byggd för
+dessa två.
 - `data-app="jubb"` → Blue accent (Radix Blue Dark), Blue-tonad bakgrund
 - `data-app="ekonom"` → Plum accent (Radix Plum Dark), Plum-tonad bakgrund
-- Ny app: lägg till ramp i 00-primitives.css + apps/foo.css med accent-
-  overrides (obligatoriskt, 5 rader) + valfria surface/text-overrides
-  (15-40 rader totalt om appen ska ha distinkt bakgrundston)
-- **Surface-raised-konvention**: alla Klodd-appar sätter
+- **Surface-raised-konvention**: bägge apparna sätter
   `--surface-raised: var(--<color>-2)` - kort och paneler ligger på
   samma yta som default-sektioner men distinkt mot page-bakgrunden
-  (color-1). Gäller alla nuvarande och framtida appar.
+  (color-1).
 
 ## Besluts-records
 - `references/04-locked-decisions/` — låsta beslut. Förklara, ändra inte.
@@ -115,6 +122,11 @@ cd ~/dev/Jubb && npm install @klodd/ds@latest && npm run build:ds
 cd ~/dev/Ekonom && npm install @klodd/ds@latest && npm run build:ds
 ```
 
+**OBS:** build:ds rensar inte borttagna filer. Efter en
+komponent-radering: verifiera manuellt att
+`app/static/css/ds/components/<borttagen>.css` inte finns kvar i
+apparna.
+
 ## Sprint-avslut: alla sprintar kräver detta
 En sprint — oavsett om den innehåller CSS, JS eller bara dokumentation —
 är inte klar förrän:

package/css/components/hero.css

@@ -93,7 +93,7 @@
      Gemensamma utgifter) dar parent ar text-align:left. Center-just
      overrode den left-align via flex. Nu foljer amount-row parent-
      justification. Gap-16 ger luft mellan summa och adjacent
-     actions-knappar (btn-copy, btn-bank). */
+     actions-knappar. */
   display: flex;
   align-items: center;
   justify-content: flex-start;

package/css/components/nav.css

@@ -159,12 +159,20 @@
   justify-self: end;
 }
 
+.topbar > a:has(> .avatar) {
+  min-width: var(--touch-min);
+  min-height: var(--touch-min);
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+}
+
 .topbar__back {
   display: inline-flex;
   align-items: center;
   justify-content: center;
-  width: 36px;
-  height: 36px;
+  width: var(--touch-min);
+  height: var(--touch-min);
   padding: 0;
   border: 1px solid var(--border-subtle);
   border-radius: var(--radius-full);
@@ -203,8 +211,8 @@
   display: inline-flex;
   align-items: center;
   justify-content: center;
-  min-width: var(--touch-sm);
-  min-height: var(--touch-sm);
+  min-width: var(--touch-min);
+  min-height: var(--touch-min);
   padding: 0 var(--space-10);
   background: transparent;
   border: 0;

package/css/components/pwa-avatar.css

@@ -16,8 +16,8 @@
   display: inline-flex;
   align-items: center;
   justify-content: center;
-  width: 36px;
-  height: 36px;
+  width: var(--touch-min);
+  height: var(--touch-min);
   padding: 0;
   background: var(--accent-soft);
   color: var(--accent-text);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@klodd/ds",
-  "version": "5.4.1",
+  "version": "5.4.3",
   "description": "Klodd shared design system - tokens, components, JS",
   "main": "css/index.css",
   "bin": {

package/references/02-components.md

@@ -239,20 +239,6 @@ Se /design-sidan "Completion Dialog"-sektionen for visuella exempel.
 - **Anvand:** Panel som expanderar pa klick. JS togglar `data-expanded`
 - **INTE:** Modal-content (anvand `.dialog` eller `.sheet`)
 
-### hbar (`hbar.css`)
-- **Blocks:** `.hbar`
-- **Element:** `.hbar__item`, `.hbar__track`, `.hbar__fill`, `.hbar__label`, `.hbar__value`
-- **Modifiers:** `.hbar__fill--positive/-warning/-negative`
-- **Anvand:** Generisk horisontell bar med label + value + track + fill
-- **INTE:** Status-progress (anvand `.progress`)
-
-### split-bar (`split-bar.css`)
-- **Blocks:** `.split-bar`
-- **Element:** `.split-bar__segment`, `.split-bar__label`, `.split-bar__labels`
-- **Modifiers:** `.split-bar__segment--primary/-secondary/-positive/-negative/-warning`
-- **Anvand:** Flersegment-bar for cost-split, debt-vs-equity m.fl.
-- **INTE:** Single-bar-progress (anvand `.hbar`)
-
 ### hero (`hero.css`)
 - **Blocks:** `.hero`
 - **Element:** `.hero__heading`, `.hero__amount`, `.hero__amount-row`, `.hero__label`, `.hero__meta`, `.hero__actions`
@@ -455,7 +441,7 @@ Definiera tokens + bindningar:
   app-domain-CSS-bindningar ar att foredra (data-attribute-konvention
   + lasbar template)
 
-Jubb, Ekonom, framtida appar foljer samma monster med sina egna tokens.
+Jubb och Ekonom foljer samma monster med sina egna tokens.
 
 
 ## Anti-patterns
@@ -601,7 +587,6 @@ Tier D-undantag (Sprint G 2026-05-09, listade i sektionen ovan):
 - `.budget-bar-*` (5 klasser)
 - `.cat-tx-*` (6 klasser, .cat-tx-stack har BEM-element)
 - `.cost-bar` / `.cost-bar-seg` (2 klasser, sibling-pair)
-- `.split-bar` (paketet har samma, override-styling)
 
 Notera: ekonom-domain.css (kategori-tokens + bindings) listas inte har
 - den filen ar token-definition, inte komponent-CSS. Se ADR

package/references/04-locked-decisions/0003-radix-colors-oklch.md

@@ -20,7 +20,7 @@ Anvand **officiella Radix Colors dark-skalor** rakt av:
 - Mauve (neutral - se ADR 0006)
 - Blue Dark (Jubb accent)
 - Plum Dark (Ekonom accent)
-- Violet Dark (forberedd for framtida app)
+- Violet Dark (definierad, inte aktivt anvand)
 - Green/Amber/Red Dark (status)
 
 Plus alpha-skalor (Mauve/Blue/Plum) for transparency-tints.

package/references/04-locked-decisions/0006-mauve-neutral.md

@@ -26,10 +26,6 @@ Mauve Dark, INTE ren gray eller slate.
 - + Subtle lila-tonad ger varmare bottenton som matchar bagge
   app-accenterna
 - + Konsistent visuellt sprak over apparna - bagge har samma neutral
-- − Mauve passar INTE for en framtida gron- eller orange-accent-app.
-  Inte planerat - om det blir aktuellt valjer vi neutral utifran den
-  appens accent vid den punkten (kanske separat data-app + neutral-
-  override)
 - − Vissa anvandare kan kanna sig ovana med varmare neutral - branschen
   ar dominerad av kallare gray/slate
 

package/references/04-locked-decisions/0015-panel-title-tag-doctrine.md

@@ -6,7 +6,7 @@ Locked.
 ## Context
 
 Audit 2026-05-13 kvällsessionen avslöjade två problem med
-`.panel__title`-användning över Klodd-ekosystemet:
+`.panel__title`-användning över Jubb och Ekonom:
 
 **Problem 1: Inkonsekvent HTML-tagg i Ekonom.**
 - 35 platser använder `<div class="panel__title">` (94%)
@@ -89,7 +89,7 @@ Här är `.hero__label` korrekt eftersom `.hero__amount--card` följer.
   som h3 default)
 - CSS oförändrad - `.panel__title`-stylling targetar klassen, inte
   taggen
-- Konsekvens över Klodd-ekosystemet (Jubb + Ekonom + framtida appar)
+- Konsekvens över Jubb och Ekonom
 
 **Trade-offs:**
 - Heading-hierarki är inte alltid h1→h2→h3 över hela sajten. Vyer utan

package/references/04-locked-decisions/0016-mina-sidor-doctrine.md

@@ -105,13 +105,11 @@ används av alla nuvarande och framtida Klodd-appar.
 |---|---|
 | Ekonom | Min ekonomi (inkomst, saldo) + Mina inställningar (toggles, abonnemang) |
 | Jubb | Skip "Min [domän]" → Mina inställningar (Sökläge, Notiser, AI-profil) |
-| Future-app | "Min [domän]" om personliga värden finns separat |
 
 ## Konsekvenser
 
 **Bra:**
 - Single source of truth för settings-hubbar
-- Future-Margevo + framtida appar får gratis-pattern
 - A11y + iOS-konvention: heading-hierarki + setting-row-rytm
 - Komposit av befintliga paket-komponenter (ingen ny CSS behövs)
 

package/references/04-locked-decisions/0020-domain-to-package-lift.md

@@ -1,7 +1,7 @@
 # 0020 - Domain-to-package lift: alla Ekonom-specifika block lyfts
 
 ## Status
-Locked. Minor version-bump (4.4.0) - additive paket-utvidgning.
+Superseded by ADR 0024 (2026-05-20). Var ursprungligen Locked (minor version-bump 4.4.0, additiv paket-utvidgning).
 
 ## Context
 
@@ -196,7 +196,7 @@ Bagge appars `design.html` utokas med 14 nya sektioner:
 **Bra:**
 - Calle's princip uppfylld: "lyft eller drop". Paketet ar nu fullt
   designsystem - alla komponenter Ekonom anvander finns i paketet.
-- Future-appar kan anvanda alla 17 utan att fork:a Ekonom-domain.
+- Alla 17 komponenter ligger i paketet, ingen behover fork:a Ekonom-domain.
 - /design visar 100% av apparnas faktiska CSS-yta (efter utvidgning).
 - BEM-disciplin uppratthallen: alla nya block foljer block + element +
   modifier-struktur. Inga 3-niva-nesting (`__elem__sub`).

package/references/04-locked-decisions/0023-progress-list-utility.md

@@ -15,7 +15,7 @@ Tidigare bodde dessa som `.cat-bar-list` + `.cat-bar-row` i Ekonoms
 separata). Lyft till paketet för att:
 
 1. Eliminera Ekonom-domain-CSS som inte är domain-specifikt
-2. Ge framtida appar samma list-pattern utan kopiering
+2. Göra list-mönstret tillgängligt i paketet utan kopiering
 3. Tydliggöra att klassen wrappar `.progress` (inte är en alternativ
    bar-stil)
 

package/references/04-locked-decisions/0024-tightened-component-lift-doctrine.md

@@ -0,0 +1,135 @@
+# 0024 - Skärpt komponent-lyft-doktrin (supersedes 0020)
+
+## Status
+Locked (2026-05-20). Supersedes ADR 0020.
+
+## Context
+
+ADR 0020 (2026-05-14) lyfte 17 Ekonom-domän-block till paketet på
+principen "lyft eller drop, ingen mellanversion". 8 hamnade som egna
+filer i `css/components/`.
+
+Audit fas 6 + fas 11 (2026-05-20) verifierade: alla 8 hade exakt EN
+konsument (Ekonom). Jubb använde noll i produktion. Det var
+relokering, inte generalisering - Ekonoms domän-CSS flyttades in i
+det delade paketet och kallades "delat" trots en enda konsument.
+
+Rotfelet: ADR 0020 lyfte på kriteriet "kan delas" (komponenten är
+generisk nog att en annan app SKULLE kunna använda den) i stället
+för "delas" (en andra app använder den faktiskt). "Kan delas" är ett
+subjektivt omdöme som nästan vad som helst passerar.
+
+Dessutom introducerade lyftet en state-regression: `matched-row` och
+`expandable-row__header` tappade `:active`-press-feedback som
+originalen (`.sub-row`, `.cat-row__header`) hade via `base.css`
+press-feedback-selektorlista (fas 2d/7a). Ingen checklist fångade det.
+
+## Decision
+
+ADR 0024 supersedes ADR 0020:s lyft-kriterium. Tre regler:
+
+1. **Minst två dokumenterade konsumerande appar krävs innan lyft.**
+   @klodd/ds har exakt två konsumenter - Jubb och Ekonom (scope
+   fixerat, beslut #4, 2026-05-20). "Minst två konsumenter" betyder
+   därför i praktiken: BÅDA apparna använder komponenten, med en
+   namngiven verifierad plats (fil:rad) i var. Det betyder INTE
+   "vänta på en framtida tredje app" - det finns ingen tredje app och
+   ingen planeras. En komponent som bara en av de två apparna
+   använder hör hemma i den appens domän-CSS, inte i paketet. Ett
+   omdöp till generiskt namn skapar ingen andra konsument. Att
+   tillverka en konsument efteråt - få den andra appen att adoptera
+   komponenten enbart för att rättfärdiga lyftet - är YAGNI baklänges
+   och förbjudet.
+
+2. **State-täckning-checklist obligatorisk vid lyft.** Före lyft:
+   räkna upp original-komponentens interaktiva states (`:hover`,
+   `:active`, `:focus-visible`, `:disabled`). Efter lyft: verifiera
+   att paket-versionen reproducerar varenda en. Inga state-
+   regressioner. Press-feedback som låg implicit i app-`base.css`-
+   selektorlistor måste flyttas explicit till paket-komponenten.
+
+3. **Komponent-lyft-ADR-mallen ska innehålla kontrollpunkterna**
+   strukturerat (se Mall nedan), ifyllda, innan ADR:n kan låsas.
+
+## Mall för framtida komponent-lyft-ADR
+
+### Konsument-verifiering (regel 1)
+- Konsument 1: [app] [fil:rad]
+- Konsument 2: [app] [fil:rad]
+- (Bägge apparna - Jubb och Ekonom - krävs. Bara en: komponenten
+  stannar i den appens domän-CSS.)
+
+### State-täckning (regel 2)
+| State          | Original | Paket-version | Regression? |
+|----------------|----------|---------------|-------------|
+| :hover         |          |               |             |
+| :active        |          |               |             |
+| :focus-visible |          |               |             |
+| :disabled      |          |               |             |
+
+## Backfill - ADR 0020-lyften omprövade (beslut #3, 2026-05-20)
+
+Alla 8 single-consumer-komponenter från ADR 0020 flyttas tillbaka
+till Ekonom. Ingen behålls i paketet. Regel 1 tillämpas strikt på
+samtliga.
+
+Tillbaka till Ekonom:
+- Domän-compounds: `expandable-row`, `item-stack`, `matched-row`.
+  Kodar Ekonoms avstämnings-vokabulär; ett generiskt namn dolde det.
+- Tidigare klassade "paket-primitiv": `icon-circle`, `status-icon`,
+  `review-banner`. Generiska till formen, men 1 konsument.
+- Tidigare klassade "paket-utility": `kvp-arrow`, `kvp-target`,
+  `tag-inline`. För tunna för komponenter, men ändå 1 konsument.
+
+Implementations-spec: `audits/sprint-2-checklist.md` Del B. Paketets
+`css/components/` krymper 47 till 39 filer.
+
+När en andra app konkret behöver någon av dem: lyft enligt regel
+1 + 2 + 3. Verifierad konsument 1 + verifierad konsument 2 = lyft.
+Inte tidigare.
+
+## Why no grandfathering
+
+Ett tidigare utkast föreslog att behålla `icon-circle`/`status-icon`/
+`review-banner` i paketet med motiveringen "verifierat generiska,
+flyttkostnaden överstiger bärkostnaden". Det förkastades.
+
+Det är samma resonemang som ADR 0020 byggde på. ADR 0020 lyfte på
+"komponenten är generisk nog att kunna delas" - och auditen (fas 12
+slutsats #4, YAGNI) visade att just det resonemanget fyllde paketet
+med single-consumer-kod. Ett undantag inskrivet i den nya doktrinen
+dag ett återöppnar exakt den lucka doktrinen finns för att stänga.
+"Verifierat generisk" är inget objektivt kriterium - det är samma
+subjektiva omdöme som "kan delas", omformulerat.
+
+Regeln måste vara mekanisk för att hålla: två verifierade
+konsumenter, inga omdömen, inga undantag. En liten generisk primitiv
+som bara en app använder kostar nästan inget att låta bo i appens
+CSS tills den andra konsumenten finns. Den kostar betydligt mer att
+bära i paketet som prejudikat för nästa "den här kan ju delas"-lyft.
+
+## Konsekvenser
+
+Bra:
+- Paketet slutar samla single-consumer-domän-CSS. "Delad komponent"
+  betyder bevisat delad. `css/components/` krymper 47 till 39 filer.
+- State-regressioner som `:active`-tappet fångas mekaniskt av
+  checklistan.
+- Doktrinen har inga undantag - den kan inte urholkas av omdömen.
+
+Trade-off:
+- Ett genuint generiskt mönster som bara en app behöver idag måste
+  vänta i appens CSS tills den andra appen behöver det. Avsiktligt -
+  vänta-kostnaden är låg, junk-drawer-kostnaden är hög.
+
+ADR 0020:s anda ("lyft eller drop, ingen mellanversion") kvarstår,
+men "lyft" omdefinieras: lyft = bägge apparna är verifierade
+konsumenter; 1 konsument = drop (stanna i appen). Mellanversionen
+ADR 0020 i praktiken skapade (1-konsument-kod i paketet) är nu
+explicit förbjuden, utan undantag.
+
+## References
+- ADR 0020 (superseded av denna)
+- ADR 0013 (visual coherence / press-feedback-doktrin)
+- Fas 6 (component-coverage), fas 11b, fas 12 slutsats #4 (YAGNI)
+- Beslut #3 och #4 (2026-05-20)

package/references/04-locked-decisions/{0015-turbo-nav-script-init.md → 0025-turbo-nav-script-init.md}

@@ -1,10 +1,12 @@
-# 0009 - Per-page-JS-init under turbo-nav
+# 0025 - Per-page-JS-init under turbo-nav
 
 ## Status
 
 Locked. Upptäckt v192 (2026-05-19) under Chrome MCP-diagnos av
 brief-progress-flödet i Jubb.
 
+*Omnumrerad 2026-05-20: filnamnet sa 0015 (kollision med ADR 0015 panel-title-tag-doctrine) och H1 sa felaktigt 0009. Bägge korrigerade till 0025.*
+
 ## Context
 
 `turbo-nav.js` (paketet) implementerar same-document-navigation

package/references/04-locked-decisions/{0016-async-progress-fetch-fn.md → 0026-async-progress-fetch-fn.md}

@@ -1,9 +1,11 @@
-# 0016 - AsyncProgress fetchFn-option
+# 0026 - AsyncProgress fetchFn-option
 
 ## Status
 
 Locked (2026-05-19).
 
+*Omnumrerad 2026-05-20: filnamnet sa 0016 (kollision med ADR 0016 mina-sidor-doctrine), korrigerad till 0026.*
+
 ## Context
 
 `KloddDS.AsyncProgress` (introducerad 5.3.0) använder intern `fetch()`

package/references/05-open-decisions/0001-tx-row-to-list-row-migration-CLOSED.md

@@ -58,7 +58,7 @@ domanen). Generaliserat namn `.list-row` finns redan i paketets
 `.list-row` som paritets-namn (paketets klass aktiverad globalt)
 **Pros:**
 - Inga template-andringar i Ekonom
-- Paketets `.list-row` blir tillganglig for Jubb och framtida apps
+- Paketets `.list-row` blir tillganglig for Jubb
 **Cons:**
 - Driften mellan apparna fortsatter (Ekonom anvander `.tx-*`, Jubb
   hypotetiskt skulle anvanda `.list-row`)

package/references/05-open-decisions/0008-legacy-token-migration-CLOSED.md

@@ -18,7 +18,7 @@ Originaltexten bevarad nedan for historik.
 ---
 
 ## Original status (innan stangning)
-Pending. Trigger: innan tredje app borjar anvanda `@klodd/ds`.
+Pending. Trigger: nar paketet behover mogna bort sin legacy-skuld.
 
 ## Context
 `10-semantic.css` har en LEGACY ALIASES-sektion (rad 412-506) som
@@ -52,7 +52,7 @@ kostnad.
   appar.
 
 ## Decision
-Gor en fullstandig **lock-sprint** innan tredje app laggs till:
+Gor en fullstandig **lock-sprint** for att mogna paketet:
 
 1. Migrera ALLA call-sites till nya semantic token-namn
    (`--accent` -> `--accent-9` eller `--accent-text`, `--bg-base`
@@ -67,7 +67,7 @@ Gor en fullstandig **lock-sprint** innan tredje app laggs till:
 ## Consequences
 - **+** Slut pa dubbla mentala modeller. En standard.
 - **+** Spec stammer med implementationen.
-- **+** Tredje app:s onboarding gar mot ett moget system.
+- **+** Paketet gar mot ett moget system.
 - **+** `npx @klodd/ds verify` (3.4.0+) detekterar drift mekaniskt.
 - **-** Stor sprint - kraver dedikerad bandbredd (uppskattning: 2-3
   arbetsdagar plus visuell QA per app).
@@ -75,9 +75,9 @@ Gor en fullstandig **lock-sprint** innan tredje app laggs till:
   styleguide-jamforelse fore/efter pa bagge appar.
 
 ## Pending decision criteria
-- Tidpunkt: omedelbart innan tredje app (Margevo eller annan)
-  borjar anvanda paketet. Att vanta langre forharder skulden;
-  att hasta forskuggar appar som redan ar i prod.
+- Tidpunkt: nar bandbredd finns for att mogna paketet. Att vanta
+  langre forharder skulden; att hasta forskuggar appar som redan
+  ar i prod.
 - Vem kor sprinten: Calle ensam eller med assistent CC?
 - Om CC: ska den ha access till bagge app-repos under sprinten?
 

package/references/05-open-decisions/0014-ekonom-colored-row-migration-CLOSED.md

@@ -8,8 +8,7 @@ Option B: minimal cleanup.
 
 Ekonom uses .cat-list-row without border-left as a deliberate visual
 choice. border-left on categorized rows is unwanted in current apps.
-.colored-row remains in the package for future apps that may want
-the pattern.
+.colored-row remains in the package as an available pattern.
 
 Dead --row-accent bindings removed from ekonom-domain.css.
 

package/references/05-open-decisions/0017-async-progress-pipeline-gaps.md

@@ -0,0 +1,136 @@
+# 0017 - AsyncProgress: pipeline-flödes-gaps
+
+## Status
+
+Pending.
+
+## Context
+
+`pipeline-progress.js` i Jubb migrerades till `KloddDS.AsyncProgress`-
+wrapper (Jubb v202, 2026-05-19, commit `f46ff70`). Brief-progress.js
+hade redan migrerats tidigare samma dag (`d532e7e`). Under pipeline-
+migrationen identifierades tre paket-gaps som krävde workarounds i
+wrappern eftersom paketets default-beteende är optimerat för ett-shot-
+flöden (brief-flödet) snarare än kontinuerlig polling (pipeline-flödet).
+
+### Gap 1 — continuousMode
+
+**Behov:** polling fortsätter efter `done`-callback för att detektera
+nya körningar automatiskt. Pipeline-progress visar status på senaste
+DigestRun - när en run klar och en ny startar måste klienten plocka upp
+den utan sidladdning.
+
+**Workaround:** `onComplete → setTimeout(2s) → ny AsyncProgress-instans`
+(recursive restart). Ren ny instans varje cykel för att undvika att
+återanvända en stoppad poller.
+
+**Risk:** fragil mot paket-omstrukturering av lifecycle. Om AsyncProgress
+ändrar onComplete-semantik (t.ex. flyttar invokation till efter
+internal cleanup) kan restart-pattern brytas. Plus memory-overhead -
+varje ny instans skapar nya closures (acceptabel för once-per-N-minute
+körningar).
+
+### Gap 2 — autoHide: false
+
+**Behov:** komponenten ska vara hidden tills `data.active === true`.
+Pipeline kan vara inaktiv vid sidladdning (vanligaste fallet eftersom
+crons kör 3 ggr/dag). `progressEl` ska inte flasha tomt block.
+
+**Workaround:** `root.hidden = true` direkt efter `start()` +
+transform-managed visibility via `root.hidden = !data.active` i varje
+poll-tick.
+
+**Risk:** race om `start()` async-unhidar innan transform körs.
+Nuvarande AsyncProgress.start() är synkron (`removeAttribute("hidden")`
+i konstruktor-anrop), så pattern fungerar deterministiskt. Om paketet
+ändras till async-init (t.ex. wait för DOM-ready) kan en kort flash
+uppstå mellan start() och första transform.
+
+### Gap 3 — extraRenders
+
+**Behov:** rendera side-elements utanför paketets bar/label/pct-scope.
+Pipeline har `batch_progress_label` som renderas parallellt med
+progress-bar (visar "Batch 3 av 7" o.s.v. under bar:en).
+
+**Workaround:** transform-callback renderar elementet som side-effect:
+
+```javascript
+function transformPayload(data) {
+  if (batchLabel) {
+    batchLabel.hidden = !data.batch_progress_label;
+    if (data.batch_progress_label) batchLabel.textContent = data.batch_progress_label;
+  }
+  // ...returnerar normal { status, stage, pct, label }
+}
+```
+
+**Risk:** side-effects i transform bryter single-responsibility-
+principen. Transform är dokumenterad som ren payload-normalisering
+(`(data) → { status, stage, pct, label, ... }`). DOM-skrivning i en
+"pure" transform är subtilt fel arkitektur. Plus svår att testa
+(transform-funktion ärver implicit DOM-state).
+
+## Considered options
+
+### A. Lägg till alla tre som opt-in options i AsyncProgress
+
+```javascript
+new KloddDS.AsyncProgress({
+  progressEl: el,
+  pollUrl: "...",
+  continuousMode: true,
+  autoHide: false,
+  extraRenders: [
+    { el: batchLabel, valueKey: "batch_progress_label", hideWhenEmpty: true },
+  ],
+});
+```
+
+- Minor-bump till 5.5.0 (additive features, ingen breaking change)
+- ADR krävs (locked-decision om continuous-mode-semantik:
+  vad menas exakt med "kontinuerligt" - polling-paus efter done?
+  retry-loop? backoff?)
+- Cleaning workarounds i Jubb's wrapper (~10 LOC sparade per gap)
+
+### B. Lägg till bara continuousMode (vanligaste behovet)
+
+- Patch-bump möjlig om semantik håller sig till "fortsätt polla
+  efter done" utan att rubba existing onComplete-kontrakt
+- continuousMode triggar en onComplete-callback, men polling-loopen
+  fortsätter ostörd istället för att rensa pollTimer
+- Klient kan opt-in via boolean utan ny config-struktur
+
+### C. Behåll workarounds tills ett tredje use-case dyker upp
+
+- Ingen paket-ändring
+- Pipeline + brief är två use-cases. Tredje (Ekonom bank-sync eller
+  framtida feature) skulle trigga konsolidering
+- Workarounds dokumenteras i Jubb's wrapper (redan gjort i
+  JSDoc-header för `pipeline-progress.js`)
+
+## Pending decision criteria
+
+Aktiveras när:
+
+- Ekonom bank-synk eller annan app adopterar AsyncProgress och stöter
+  på samma gaps (continuous polling + lazy-show + extra-rendering).
+  Aktuell ETA okänd - bank-synk är planerad men inte påbörjad per
+  Ekonom DECISIONS.md
+- Eller: workarounds visar sig instabila i prod (memory-leak från
+  recursive instances, race-condition på start()-hide, transform-
+  test-flakiness)
+
+Inte prioriterat förrän en av ovan inträffar. Wrappern fungerar i
+produktion (Jubb v202+) - gaps är arkitektur-städ, inte funktionalitet.
+
+## References
+
+- Jubb commit `f46ff70` - pipeline-progress migration som upptäckte
+  gaps
+- Jubb commit `d532e7e` - brief-progress migration (ett-shot-flöde som
+  matchar AsyncProgress's default-design)
+- ADR 0026-async-progress-fetch-fn (`04-locked-decisions/`) - tidigare
+  AsyncProgress-utvidgning för demo/test-injection via fetchFn
+- `~/dev/klodd-ds/js/async-progress.js` - paket-implementation
+- `~/dev/Jubb/app/static/js/pipeline-progress.js` - wrapper med
+  workarounds (68 LOC)

package/references/05-open-decisions/0018-build-ds-prune.md

@@ -0,0 +1,35 @@
+# 0018 - build:ds prune-gap
+
+## Status
+
+Pending.
+
+## Context
+
+build:ds (`npx @klodd/ds sync`) kopierar paketets filer till
+`app/static/css/ds/` och `app/static/js/ds/` men tar inte bort filer
+som raderats ur paketet. Upptäckt vid 5.4.2-cleanup: `hbar.css` +
+`split-bar.css` låg kvar i båda appar efter build:ds och krävde
+manuell borttagning.
+
+## Decision needed
+
+Lägg till `--prune`-flagga i sync-kommandot som tar bort filer i
+målmappen som inte längre finns i paketet.
+
+## Considered options
+
+### A. Implementera --prune i sync-skriptet
+Rensar automatiskt vid varje build:ds.
+
+### B. Dokumentera manuellt städ-steg i SKILL.md
+"efter paket-publish: verifiera att raderade komponenter tas bort ur
+app build-output".
+
+### C. Behåll nuvarande beteende
+Risk för stale filer vid varje komponent-radering.
+
+## Pending decision criteria
+
+Aktiveras nästa gång en komponent raderas ur paketet. Option B är
+interim-lösning tills A implementeras.

package/references/DESIGN-LANGUAGE.md

@@ -1,6 +1,6 @@
 # Klodd Design Language
 
-Konkreta regler för **visuell koherens** över Klodd-ekosystemet. Token-
+Konkreta regler för **visuell koherens** över @klodd/ds (Jubb och Ekonom). Token-
 arkitekturen (`01-tokens.md`) och komponent-API (`02-components.md`)
 specificerar **vad** som finns; denna fil specificerar **hur** komponenter
 ska användas tillsammans för homogen design-uttryck.