@vectoriox/iox-ui 5.23.0 → 5.25.0

package/design-core/index.d.ts

@@ -8797,10 +8797,26 @@ interface SeedExpectation {
     dark?: string;
 }
 /**
- * What the PREVIOUS seed wrote, per row: a map by name, or a function of the stored row (a baseline
- * that depends on WHICH seed stamped the row — the Swiss → Crisp migration's case).
+ * What a previous seed wrote, per row: a map by name, or a function of the stored row (a baseline that
+ * depends on WHICH seed stamped the row — the Swiss → Crisp migration's case). The function may name
+ * several values: a machine row is untouched when it holds ANY of them (`designBaseline`: what the
+ * previous design wrote, and what the row's own pack writes at its defaults).
  */
-type SeedBaseline = ReadonlyMap<string, SeedExpectation> | ((row: StoredDesignTokenRow) => SeedExpectation | undefined);
+type SeedBaseline = ReadonlyMap<string, SeedExpectation> | ((row: StoredDesignTokenRow) => SeedExpectation | ReadonlyArray<SeedExpectation> | undefined);
+/** Options of a seed pass. */
+interface FlavorSeedOptions {
+    /** Rows the author asked to take the look's values too ("Use the look's values for these too"):
+     *  written like an untouched row instead of being kept. */
+    reclaim?: Iterable<string> | null;
+}
+/**
+ * A machine-stamped row is untouched when it holds what a seed wrote — or that seed's LIGHT value with no
+ * dark half at all: iox-cms dropped every `values.dark` from F0 to DS4.1, and no author edit produces that
+ * shape (the Tokens panel edited the light value only, and since DS8 an edit makes the row `source: user`).
+ * Judging it edited kept the six brand rows of every studio seeded before DS4.1 on the default blue for
+ * good — a later brand never reached them.
+ */
+declare function untouchedSeedRow(row: StoredDesignTokenRow, expected: ReadonlyArray<SeedExpectation>): boolean;
 /**
  * The seeding MERGE: desired tokens vs existing rows, deciding create / update / keep. The §10 C2
  * rule — "an upgrade only rewrites untouched rows" — is a comparison against what the PREVIOUS
@@ -8811,11 +8827,12 @@ type SeedBaseline = ReadonlyMap<string, SeedExpectation> | ((row: StoredDesignTo
  * choice, so a new choice may replace it. `group`/`tier` ride every write; a desired row's own
  * `source` (a chosen font's `user`) wins over the pack stamp. A machine-owned row that already holds
  * the desired value but another pack's stamp is RE-STAMPED (§10 C2 provenance: the stamp names the
- * design that owns the row, so the next switch judges it against the right baseline).
+ * design that owns the row, so the next switch judges it against the right baseline). A row named in
+ * `options.reclaim` is written whatever it holds — the author chose the look's value over their own.
  */
 declare function planFlavorSeed(desired: ReadonlyArray<FlavorTokenDef & {
     source?: string;
-}>, existing: ReadonlyArray<StoredDesignTokenRow>, stamp: string, baseline: SeedBaseline | null): FlavorSeedPlan;
+}>, existing: ReadonlyArray<StoredDesignTokenRow>, stamp: string, baseline: SeedBaseline | null, options?: FlavorSeedOptions): FlavorSeedPlan;
 
 interface LinearSpring {
     easing: string;
@@ -9126,10 +9143,25 @@ declare function designTokenRows(choices: DesignChoices): DesignTokenRow[];
  * (for an org with no design row, Crisp's defaults — exactly what DS2's interim seed wrote). In a
  * Swiss org the only v2 rows are that interim seed's, so they are judged against Crisp's DEFAULTS,
  * never against the brand-seeded Crisp the migration is about to write.
+ *
+ * A row a v2 pack stamped is ALSO untouched while it holds what that pack writes at its own defaults —
+ * what DS2's interim seed, a first run and every pack card at its defaults wrote. Without it, one row
+ * kept for any reason (a dark half iox-cms dropped, `untouchedSeedRow`) was judged against a design that
+ * had moved on, apply after apply, and stayed on the old value for good: the studio's brand colour
+ * reached the design row and never its accent.
  */
 declare function designBaseline(previous: StoredDesign): SeedBaseline;
-/** Apply `next` over the org's rows, judged against `previous` — the plan FlavorApplyService runs. */
-declare function planDesignApply(existing: ReadonlyArray<StoredDesignTokenRow>, previous: StoredDesign, next: DesignChoices): FlavorSeedPlan;
+/** Options of an apply. */
+interface DesignApplyOptions {
+    /** The kept rows the author asked to take the look's values too (`FlavorSeedOptions.reclaim`). */
+    reclaim?: FlavorSeedOptions['reclaim'];
+}
+/**
+ * Apply `next` over the org's rows, judged against `previous` — the plan FlavorApplyService runs. The
+ * plan's `kept` names the author's rows the look leaves alone; the Design card lists them before Apply,
+ * and `options.reclaim` writes the look's value into the ones the author hands back.
+ */
+declare function planDesignApply(existing: ReadonlyArray<StoredDesignTokenRow>, previous: StoredDesign, next: DesignChoices, options?: DesignApplyOptions): FlavorSeedPlan;
 /**
  * "Revert to previous look" over the org's rows — the ONE plan the Revert executes and its hint counts
  * (`kept`: the author's edits since the apply, left as they are). The apply's record of what it wrote
@@ -9143,12 +9175,18 @@ declare function missingDesignRows(existing: ReadonlyArray<{
     name: string;
 }>, choices: DesignChoices): DesignTokenRow[];
 /**
- * The builder-load REPAIR (DS4.1): rows the design owns and nobody touched — stamped by the current
- * pack, light value exactly the pack's — whose dark override differs from the pack's are rewritten.
- * iox-cms dropped `values.dark` on every write from F0 to DS4 (`values` was an implicit relation),
- * and a revert could leave the previous apply's dark behind; both leave a row whose light half is the
- * design's and whose dark half is not. No author edit can produce that shape — the Tokens panel edits
- * the light value only — so rewriting it heals existing orgs without the author doing anything.
+ * The builder-load REPAIR (DS4.1): rows the design writes that are the machine's and nobody touched,
+ * yet hold something other than the design's value, are rewritten — so an org heals on its next load
+ * with no author action. Two shapes:
+ * - stamped by the current pack, light value exactly the pack's, dark half not: iox-cms dropped
+ *   `values.dark` on every write from F0 to DS4 (`values` was an implicit relation), and a revert could
+ *   leave the previous apply's dark behind;
+ * - stamped by a v2 pack and still holding what THAT pack writes at its own defaults (its dark half
+ *   possibly lost the same way) while the stored design says otherwise: an apply that judged the row
+ *   edited (before 5.24.0, a lost dark half did) left it on the default — the six brand rows of a studio
+ *   whose brand colour never reached its accent.
+ * No author edit produces either shape — the Tokens panel edited the light value only, and since DS8 an
+ * edit makes the row `source: user`, which this never touches.
  */
 declare function designTokenRepairs(existing: ReadonlyArray<StoredDesignTokenRow>, choices: DesignChoices): FlavorSeedPlan['update'];
 interface SwissMigration {
@@ -9193,5 +9231,5 @@ interface FontFamilyRemoval {
  */
 declare function planFontFamilyRemoval(existing: ReadonlyArray<StoredDesignTokenRow>, previous: StoredDesign, family: string): FontFamilyRemoval;
 
-export { ACCENT_TOKEN_NAMES, AdoptOutcome, AdoptSkipReason, BUTTON_VARIANT_TO_STYLE, COLOR_SCHEMES, COLOR_SCHEME_TRAIT, COLOR_SCHEME_TYPES, ColorScheme, DEFAULT_FLAVOR_ID, DESIGN_TOKEN_GROUPS, DESIGN_TOKEN_TIERS, DESIGN_TOKEN_TYPES, DesignConfigKey, ELEMENT_STYLES, ELEMENT_STYLE_MARKER_CLASS, ELEMENT_STYLE_STATES, EMPTY_IMAGE_ATTRIBUTE, EMPTY_IMAGE_SRC, ElementStyleState, FLAVOR_SPEC_VERSION, FONT_CATALOG, FONT_FAMILY_TOKENS, FONT_FILE_ACCEPT, FONT_FILE_EXTENSIONS, FONT_FILE_FORMATS, FONT_STYLES, FONT_WEIGHTS, FontUploadError, GOOGLE_FONTS_CSS_ORIGIN, GOOGLE_FONTS_FILE_ORIGIN, MAX_FONT_FILE_BYTES, NEW_NODE_STYLE_DEFAULTS, OwnedTraitLink, PALETTE_PRESETS, PRE_DS2_FLAVOR_DEFAULTS, REDUCED_MOTION_OVERRIDES, REDUCED_TRANSPARENCY_OVERRIDES, REVERT_WINDOW_MS, SPEC_A11Y, SPEC_AXES, SPEC_BUTTON_VARIANT_TO_STYLE, SPEC_CONTRAST, SPEC_DEFAULT_ELEMENT_STYLE, SPEC_ELEMENT_STYLES, SPEC_FIELD_CLASS_BASELINE, SPEC_FLAVORS, SPEC_FLAVOR_PACKS, SPEC_FONTS, SPEC_FONT_ROLES, SPEC_LEGACY_ALIASES, SPEC_PALETTE_PRESETS, SPEC_SCHEMES, SPEC_SPRINGS, SPEC_TIERS, SPEC_TIER_IDS, SPEC_TOKEN_TYPES, SUPERSEDED_STYLE_VALUES, SWISS_FLAVOR, USER_TOKEN_SOURCE, WCAG_AA_TEXT, adoptElementStyles, adoptionStyleFor, apcaLc, applyElementStyle, applyHeadingLevelRule, buildFlavorTokens, buildFontFaceCss, catalogFontId, checkFontWeight, choicesForPack, colorSchemeClass, colorSchemeOf, compareFontWeights, compileSchemeCss, compileTokenCss, compileTokenCssBlocks, cssString, defaultDesignChoices, defaultElementStyleFor, deriveAccentTokens, deriveBrandTokens, designBaseline, designConfigEntries, designModeOf, designTokenRepairs, designTokenRows, elementStyleById, elementStyleClass, elementStylesFor, emptyImageLabelSrc, emptyImagePlaceholder, emptyImageSrc, flavorPackById, flavorSeedWrites, flavorSourceStamp, fontFamilyKey, fontFileName, fontFileStem, fontFormatOf, fontPreloads, fontRoleReferences, fontStackWithout, fontWeightCovers, fontWeightRange, fontWeightValue, fontsForTokens, formatFontFamilies, formatFontFamily, formatFontWeight, googleFontHref, groupFontFamilies, hasElementStyleMarker, isDesignTokenGroup, isDesignTokenTier, isDesignTokenType, isFontWeightRange, isRetiredFlavorId, legacyRuleTokenReferences, matchFontWeight, missingDesignRows, missingFontRoles, nodeDesignClasses, normalizeFontStyle, normalizeFontWeight, normalizeFontWeightValue, oklabToRgb, ownedTraitStatus, ownedTraitsOf, packDesignChoices, parseFontFamilies, parseFontWeight, parseHexColor, planDesignApply, planDesignRevert, planFlavorRevert, planFlavorSeed, planFontFamilyRemoval, planSwissMigration, previewElementStyleAdoption, previewFontWeight, readDesignConfig, readOwnedTrait, relativeLuminance, resolveDesignChoices, resolveTokenReferences, resolveTokenValues, revertAvailable, rgbToOklab, sameDesignChoices, specTokenNames, springToLinear, stackNamesFamily, styleKeyToKebab, switchElementStyle, syncNodeDesignClasses, toHexColor, tokenReferences, tokensToDarkVarMap, tokensToVarMap, unknownTokenReferences, userFontStack, validateFlavorPack, wcagContrastRatio, writeOwnedTrait };
-export type { AccentBackgrounds, AccentTokenName, AdoptContext, AdoptReport, AdoptableNode, AdoptedNode, ApplyElementStyleResult, DensityId, DesignChoices, DesignClassSource, DesignConfigEntry, DesignMode, DesignTokenGroup, DesignTokenLike, DesignTokenRow, DesignTokenTier, DesignTokenType, ElementStyle, ElementStyleTarget, ElementStyleTraitLike, FlavorPack, FlavorPackV2, FlavorRevertPlan, FlavorRevertSnapshot, FlavorRevertWrite, FlavorSeedPlan, FlavorSpecToken, FlavorTokenDef, FontDescriptor, FontFamilyGroup, FontFamilyRemoval, FontFamilyToken, FontFormat, FontPair, FontRoleToken, FontStyle, FontWeight, FontWeightRange, FontsForTokensOptions, KeptEdit, LinearSpring, MissingFontRole, MotionId, OkLab, OwnedTrait, OwnedTraitStatus, PalettePreset, ResolvedMode, Rgb, SchemeId, SeedBaseline, SeedExpectation, ShapeId, SkippedNode, StoredDesign, StoredDesignTokenRow, SupersededStyleValue, SwissMigration, SwitchElementStyleResult, TokenCssBlocks, TokenCssOptions };
+export { ACCENT_TOKEN_NAMES, AdoptOutcome, AdoptSkipReason, BUTTON_VARIANT_TO_STYLE, COLOR_SCHEMES, COLOR_SCHEME_TRAIT, COLOR_SCHEME_TYPES, ColorScheme, DEFAULT_FLAVOR_ID, DESIGN_TOKEN_GROUPS, DESIGN_TOKEN_TIERS, DESIGN_TOKEN_TYPES, DesignConfigKey, ELEMENT_STYLES, ELEMENT_STYLE_MARKER_CLASS, ELEMENT_STYLE_STATES, EMPTY_IMAGE_ATTRIBUTE, EMPTY_IMAGE_SRC, ElementStyleState, FLAVOR_SPEC_VERSION, FONT_CATALOG, FONT_FAMILY_TOKENS, FONT_FILE_ACCEPT, FONT_FILE_EXTENSIONS, FONT_FILE_FORMATS, FONT_STYLES, FONT_WEIGHTS, FontUploadError, GOOGLE_FONTS_CSS_ORIGIN, GOOGLE_FONTS_FILE_ORIGIN, MAX_FONT_FILE_BYTES, NEW_NODE_STYLE_DEFAULTS, OwnedTraitLink, PALETTE_PRESETS, PRE_DS2_FLAVOR_DEFAULTS, REDUCED_MOTION_OVERRIDES, REDUCED_TRANSPARENCY_OVERRIDES, REVERT_WINDOW_MS, SPEC_A11Y, SPEC_AXES, SPEC_BUTTON_VARIANT_TO_STYLE, SPEC_CONTRAST, SPEC_DEFAULT_ELEMENT_STYLE, SPEC_ELEMENT_STYLES, SPEC_FIELD_CLASS_BASELINE, SPEC_FLAVORS, SPEC_FLAVOR_PACKS, SPEC_FONTS, SPEC_FONT_ROLES, SPEC_LEGACY_ALIASES, SPEC_PALETTE_PRESETS, SPEC_SCHEMES, SPEC_SPRINGS, SPEC_TIERS, SPEC_TIER_IDS, SPEC_TOKEN_TYPES, SUPERSEDED_STYLE_VALUES, SWISS_FLAVOR, USER_TOKEN_SOURCE, WCAG_AA_TEXT, adoptElementStyles, adoptionStyleFor, apcaLc, applyElementStyle, applyHeadingLevelRule, buildFlavorTokens, buildFontFaceCss, catalogFontId, checkFontWeight, choicesForPack, colorSchemeClass, colorSchemeOf, compareFontWeights, compileSchemeCss, compileTokenCss, compileTokenCssBlocks, cssString, defaultDesignChoices, defaultElementStyleFor, deriveAccentTokens, deriveBrandTokens, designBaseline, designConfigEntries, designModeOf, designTokenRepairs, designTokenRows, elementStyleById, elementStyleClass, elementStylesFor, emptyImageLabelSrc, emptyImagePlaceholder, emptyImageSrc, flavorPackById, flavorSeedWrites, flavorSourceStamp, fontFamilyKey, fontFileName, fontFileStem, fontFormatOf, fontPreloads, fontRoleReferences, fontStackWithout, fontWeightCovers, fontWeightRange, fontWeightValue, fontsForTokens, formatFontFamilies, formatFontFamily, formatFontWeight, googleFontHref, groupFontFamilies, hasElementStyleMarker, isDesignTokenGroup, isDesignTokenTier, isDesignTokenType, isFontWeightRange, isRetiredFlavorId, legacyRuleTokenReferences, matchFontWeight, missingDesignRows, missingFontRoles, nodeDesignClasses, normalizeFontStyle, normalizeFontWeight, normalizeFontWeightValue, oklabToRgb, ownedTraitStatus, ownedTraitsOf, packDesignChoices, parseFontFamilies, parseFontWeight, parseHexColor, planDesignApply, planDesignRevert, planFlavorRevert, planFlavorSeed, planFontFamilyRemoval, planSwissMigration, previewElementStyleAdoption, previewFontWeight, readDesignConfig, readOwnedTrait, relativeLuminance, resolveDesignChoices, resolveTokenReferences, resolveTokenValues, revertAvailable, rgbToOklab, sameDesignChoices, specTokenNames, springToLinear, stackNamesFamily, styleKeyToKebab, switchElementStyle, syncNodeDesignClasses, toHexColor, tokenReferences, tokensToDarkVarMap, tokensToVarMap, unknownTokenReferences, untouchedSeedRow, userFontStack, validateFlavorPack, wcagContrastRatio, writeOwnedTrait };
+export type { AccentBackgrounds, AccentTokenName, AdoptContext, AdoptReport, AdoptableNode, AdoptedNode, ApplyElementStyleResult, DensityId, DesignApplyOptions, DesignChoices, DesignClassSource, DesignConfigEntry, DesignMode, DesignTokenGroup, DesignTokenLike, DesignTokenRow, DesignTokenTier, DesignTokenType, ElementStyle, ElementStyleTarget, ElementStyleTraitLike, FlavorPack, FlavorPackV2, FlavorRevertPlan, FlavorRevertSnapshot, FlavorRevertWrite, FlavorSeedOptions, FlavorSeedPlan, FlavorSpecToken, FlavorTokenDef, FontDescriptor, FontFamilyGroup, FontFamilyRemoval, FontFamilyToken, FontFormat, FontPair, FontRoleToken, FontStyle, FontWeight, FontWeightRange, FontsForTokensOptions, KeptEdit, LinearSpring, MissingFontRole, MotionId, OkLab, OwnedTrait, OwnedTraitStatus, PalettePreset, ResolvedMode, Rgb, SchemeId, SeedBaseline, SeedExpectation, ShapeId, SkippedNode, StoredDesign, StoredDesignTokenRow, SupersededStyleValue, SwissMigration, SwitchElementStyleResult, TokenCssBlocks, TokenCssOptions };

package/fesm2022/vectoriox-iox-ui-design-core.mjs

@@ -11334,8 +11334,26 @@ function flavorSeedWrites(plan, existing) {
     }
     return out;
 }
-const expectationFor = (baseline, row) => !baseline ? undefined : typeof baseline === 'function' ? baseline(row) : baseline.get(row.name);
+function expectationsFor(baseline, row) {
+    if (!baseline)
+        return [];
+    const found = typeof baseline === 'function' ? baseline(row) : baseline.get(row.name);
+    if (!found)
+        return [];
+    return (Array.isArray(found) ? found : [found]).filter(Boolean);
+}
 const sameValue = (row, e) => row.value === e.value && (row.values?.dark ?? '') === (e.dark ?? '');
+/**
+ * A machine-stamped row is untouched when it holds what a seed wrote — or that seed's LIGHT value with no
+ * dark half at all: iox-cms dropped every `values.dark` from F0 to DS4.1, and no author edit produces that
+ * shape (the Tokens panel edited the light value only, and since DS8 an edit makes the row `source: user`).
+ * Judging it edited kept the six brand rows of every studio seeded before DS4.1 on the default blue for
+ * good — a later brand never reached them.
+ */
+function untouchedSeedRow(row, expected) {
+    const darkLost = isSeeded(row) && !row.values?.dark;
+    return expected.some(e => sameValue(row, e) || (darkLost && row.value === e.value));
+}
 /**
  * The seeding MERGE: desired tokens vs existing rows, deciding create / update / keep. The §10 C2
  * rule — "an upgrade only rewrites untouched rows" — is a comparison against what the PREVIOUS
@@ -11346,10 +11364,12 @@ const sameValue = (row, e) => row.value === e.value && (row.values?.dark ?? '')
  * choice, so a new choice may replace it. `group`/`tier` ride every write; a desired row's own
  * `source` (a chosen font's `user`) wins over the pack stamp. A machine-owned row that already holds
  * the desired value but another pack's stamp is RE-STAMPED (§10 C2 provenance: the stamp names the
- * design that owns the row, so the next switch judges it against the right baseline).
+ * design that owns the row, so the next switch judges it against the right baseline). A row named in
+ * `options.reclaim` is written whatever it holds — the author chose the look's value over their own.
  */
-function planFlavorSeed(desired, existing, stamp, baseline) {
+function planFlavorSeed(desired, existing, stamp, baseline, options = {}) {
     const byName = new Map((existing ?? []).map(r => [r.name, r]));
+    const reclaim = new Set(options.reclaim ?? []);
     const plan = { create: [], update: [], kept: [] };
     for (const def of desired ?? []) {
         if (!def?.name)
@@ -11367,17 +11387,18 @@ function planFlavorSeed(desired, existing, stamp, baseline) {
             });
             continue;
         }
-        const old = expectationFor(baseline, row);
-        const designOwned = isSeeded(row) || (row.source === USER_TOKEN_SOURCE && !!old && sameValue(row, old));
-        if (!designOwned) {
+        const olds = expectationsFor(baseline, row);
+        const reclaimed = reclaim.has(def.name);
+        const designOwned = isSeeded(row) || (row.source === USER_TOKEN_SOURCE && olds.some(o => sameValue(row, o)));
+        if (!designOwned && !reclaimed) {
             plan.kept.push(def.name);
             continue;
         }
         const sameAsDesired = row.value === def.value && (row.values?.dark ?? '') === (def.values?.dark ?? '');
         if (sameAsDesired && (row.source ?? '') === source)
             continue; // already exactly this
-        const untouched = !!old && sameValue(row, old);
-        if ((untouched || sameAsDesired) && row._id) {
+        const untouched = untouchedSeedRow(row, olds);
+        if ((untouched || sameAsDesired || reclaimed) && row._id) {
             plan.update.push({ id: row._id, data: { value: def.value, values: def.values ?? {}, source, ...classification(def) } });
         }
         else {
@@ -11629,28 +11650,53 @@ function swissExpectations(seed) {
     }
     return expectations(rows);
 }
+/** What a v2 pack writes at its OWN defaults, by pack id — computed once per id per caller. */
+function packDefaultsLookup() {
+    const cache = new Map();
+    return packId => {
+        if (!cache.has(packId)) {
+            const pack = isRetiredFlavorId(packId) ? undefined : flavorPackById(packId);
+            cache.set(packId, pack && pack.id === packId ? expectations(designTokenRows(packDesignChoices(pack.id))) : undefined);
+        }
+        return cache.get(packId);
+    };
+}
 /**
  * What the PREVIOUS design wrote, as a baseline keyed by the row's own stamp: a row Swiss stamped is
  * judged against what Swiss wrote, every other row against `buildFlavorTokens` of the stored choices
  * (for an org with no design row, Crisp's defaults — exactly what DS2's interim seed wrote). In a
  * Swiss org the only v2 rows are that interim seed's, so they are judged against Crisp's DEFAULTS,
  * never against the brand-seeded Crisp the migration is about to write.
+ *
+ * A row a v2 pack stamped is ALSO untouched while it holds what that pack writes at its own defaults —
+ * what DS2's interim seed, a first run and every pack card at its defaults wrote. Without it, one row
+ * kept for any reason (a dark half iox-cms dropped, `untouchedSeedRow`) was judged against a design that
+ * had moved on, apply after apply, and stayed on the old value for good: the studio's brand colour
+ * reached the design row and never its accent.
  */
 function designBaseline(previous) {
     const retired = isRetiredFlavorId(previous.storedFlavorId);
     const current = expectations(designTokenRows(retired ? packDesignChoices(previous.choices.flavorId) : previous.choices));
     const swiss = swissExpectations(retired ? previous.storedSeed : null);
+    const packDefaults = packDefaultsLookup();
     return (row) => {
         const stampedBy = SEED_STAMP.exec(row.source ?? '')?.[1];
-        return stampedBy === SWISS_FLAVOR.id ? swiss.get(row.name) : current.get(row.name);
+        if (stampedBy === SWISS_FLAVOR.id)
+            return swiss.get(row.name);
+        const ownDefault = stampedBy ? packDefaults(stampedBy)?.get(row.name) : undefined;
+        return [current.get(row.name), ownDefault].filter((e) => !!e);
     };
 }
-/** Apply `next` over the org's rows, judged against `previous` — the plan FlavorApplyService runs. */
-function planDesignApply(existing, previous, next) {
+/**
+ * Apply `next` over the org's rows, judged against `previous` — the plan FlavorApplyService runs. The
+ * plan's `kept` names the author's rows the look leaves alone; the Design card lists them before Apply,
+ * and `options.reclaim` writes the look's value into the ones the author hands back.
+ */
+function planDesignApply(existing, previous, next, options = {}) {
     const pack = flavorPackById(next.flavorId);
     if (!pack)
         return { create: [], update: [], kept: [] };
-    return planFlavorSeed(designTokenRows(next), existing, flavorSourceStamp(pack.id), designBaseline(previous));
+    return planFlavorSeed(designTokenRows(next), existing, flavorSourceStamp(pack.id), designBaseline(previous), { reclaim: options.reclaim });
 }
 /**
  * "Revert to previous look" over the org's rows — the ONE plan the Revert executes and its hint counts
@@ -11671,12 +11717,18 @@ function missingDesignRows(existing, choices) {
     return designTokenRows(choices).filter(r => !have.has(r.name));
 }
 /**
- * The builder-load REPAIR (DS4.1): rows the design owns and nobody touched — stamped by the current
- * pack, light value exactly the pack's — whose dark override differs from the pack's are rewritten.
- * iox-cms dropped `values.dark` on every write from F0 to DS4 (`values` was an implicit relation),
- * and a revert could leave the previous apply's dark behind; both leave a row whose light half is the
- * design's and whose dark half is not. No author edit can produce that shape — the Tokens panel edits
- * the light value only — so rewriting it heals existing orgs without the author doing anything.
+ * The builder-load REPAIR (DS4.1): rows the design writes that are the machine's and nobody touched,
+ * yet hold something other than the design's value, are rewritten — so an org heals on its next load
+ * with no author action. Two shapes:
+ * - stamped by the current pack, light value exactly the pack's, dark half not: iox-cms dropped
+ *   `values.dark` on every write from F0 to DS4 (`values` was an implicit relation), and a revert could
+ *   leave the previous apply's dark behind;
+ * - stamped by a v2 pack and still holding what THAT pack writes at its own defaults (its dark half
+ *   possibly lost the same way) while the stored design says otherwise: an apply that judged the row
+ *   edited (before 5.24.0, a lost dark half did) left it on the default — the six brand rows of a studio
+ *   whose brand colour never reached its accent.
+ * No author edit produces either shape — the Tokens panel edited the light value only, and since DS8 an
+ * edit makes the row `source: user`, which this never touches.
  */
 function designTokenRepairs(existing, choices) {
     const pack = flavorPackById(choices.flavorId);
@@ -11684,12 +11736,18 @@ function designTokenRepairs(existing, choices) {
         return [];
     const stamp = flavorSourceStamp(pack.id);
     const desired = new Map(designTokenRows(choices).map(r => [r.name, r]));
+    const packDefaults = packDefaultsLookup();
     const out = [];
     for (const row of existing ?? []) {
         const want = desired.get(row.name);
-        if (!want || !row._id || row.source !== stamp || want.source !== stamp || row.value !== want.value)
+        if (!want || !row._id || want.source !== stamp)
+            continue;
+        if (row.value === want.value && (row.values?.dark ?? '') === (want.values?.dark ?? '') && row.source === stamp)
             continue;
-        if ((row.values?.dark ?? '') === (want.values?.dark ?? ''))
+        const stampedBy = SEED_STAMP.exec(row.source ?? '')?.[1];
+        const darkOnly = row.source === stamp && row.value === want.value;
+        const ownDefault = stampedBy ? packDefaults(stampedBy)?.get(row.name) : undefined;
+        if (!darkOnly && !(ownDefault && untouchedSeedRow(row, [ownDefault])))
             continue;
         out.push({ id: row._id, data: { value: want.value, values: want.values ?? {}, source: stamp, ...(want.group ? { group: want.group } : {}), ...(want.tier ? { tier: want.tier } : {}) } });
     }
@@ -11779,5 +11837,5 @@ function planFontFamilyRemoval(existing, previous, family) {
  * Generated bundle index. Do not edit.
  */
 
-export { ACCENT_TOKEN_NAMES, AdoptOutcome, AdoptSkipReason, BUTTON_VARIANT_TO_STYLE, COLOR_SCHEMES, COLOR_SCHEME_TRAIT, COLOR_SCHEME_TYPES, ColorScheme, DEFAULT_FLAVOR_ID, DESIGN_TOKEN_GROUPS, DESIGN_TOKEN_TIERS, DESIGN_TOKEN_TYPES, DesignConfigKey, ELEMENT_STYLES, ELEMENT_STYLE_MARKER_CLASS, ELEMENT_STYLE_STATES, EMPTY_IMAGE_ATTRIBUTE, EMPTY_IMAGE_SRC, ElementStyleState, FLAVOR_SPEC_VERSION, FONT_CATALOG, FONT_FAMILY_TOKENS, FONT_FILE_ACCEPT, FONT_FILE_EXTENSIONS, FONT_FILE_FORMATS, FONT_STYLES, FONT_WEIGHTS, FontUploadError, GOOGLE_FONTS_CSS_ORIGIN, GOOGLE_FONTS_FILE_ORIGIN, MAX_FONT_FILE_BYTES, NEW_NODE_STYLE_DEFAULTS, OwnedTraitLink, PALETTE_PRESETS, PRE_DS2_FLAVOR_DEFAULTS, REDUCED_MOTION_OVERRIDES, REDUCED_TRANSPARENCY_OVERRIDES, REVERT_WINDOW_MS, SPEC_A11Y, SPEC_AXES, SPEC_BUTTON_VARIANT_TO_STYLE, SPEC_CONTRAST, SPEC_DEFAULT_ELEMENT_STYLE, SPEC_ELEMENT_STYLES, SPEC_FIELD_CLASS_BASELINE, SPEC_FLAVORS, SPEC_FLAVOR_PACKS, SPEC_FONTS, SPEC_FONT_ROLES, SPEC_LEGACY_ALIASES, SPEC_PALETTE_PRESETS, SPEC_SCHEMES, SPEC_SPRINGS, SPEC_TIERS, SPEC_TIER_IDS, SPEC_TOKEN_TYPES, SUPERSEDED_STYLE_VALUES, SWISS_FLAVOR, USER_TOKEN_SOURCE, WCAG_AA_TEXT, adoptElementStyles, adoptionStyleFor, apcaLc, applyElementStyle, applyHeadingLevelRule, buildFlavorTokens, buildFontFaceCss, catalogFontId, checkFontWeight, choicesForPack, colorSchemeClass, colorSchemeOf, compareFontWeights, compileSchemeCss, compileTokenCss, compileTokenCssBlocks, cssString, defaultDesignChoices, defaultElementStyleFor, deriveAccentTokens, deriveBrandTokens, designBaseline, designConfigEntries, designModeOf, designTokenRepairs, designTokenRows, elementStyleById, elementStyleClass, elementStylesFor, emptyImageLabelSrc, emptyImagePlaceholder, emptyImageSrc, flavorPackById, flavorSeedWrites, flavorSourceStamp, fontFamilyKey, fontFileName, fontFileStem, fontFormatOf, fontPreloads, fontRoleReferences, fontStackWithout, fontWeightCovers, fontWeightRange, fontWeightValue, fontsForTokens, formatFontFamilies, formatFontFamily, formatFontWeight, googleFontHref, groupFontFamilies, hasElementStyleMarker, isDesignTokenGroup, isDesignTokenTier, isDesignTokenType, isFontWeightRange, isRetiredFlavorId, legacyRuleTokenReferences, matchFontWeight, missingDesignRows, missingFontRoles, nodeDesignClasses, normalizeFontStyle, normalizeFontWeight, normalizeFontWeightValue, oklabToRgb, ownedTraitStatus, ownedTraitsOf, packDesignChoices, parseFontFamilies, parseFontWeight, parseHexColor, planDesignApply, planDesignRevert, planFlavorRevert, planFlavorSeed, planFontFamilyRemoval, planSwissMigration, previewElementStyleAdoption, previewFontWeight, readDesignConfig, readOwnedTrait, relativeLuminance, resolveDesignChoices, resolveTokenReferences, resolveTokenValues, revertAvailable, rgbToOklab, sameDesignChoices, specTokenNames, springToLinear, stackNamesFamily, styleKeyToKebab, switchElementStyle, syncNodeDesignClasses, toHexColor, tokenReferences, tokensToDarkVarMap, tokensToVarMap, unknownTokenReferences, userFontStack, validateFlavorPack, wcagContrastRatio, writeOwnedTrait };
+export { ACCENT_TOKEN_NAMES, AdoptOutcome, AdoptSkipReason, BUTTON_VARIANT_TO_STYLE, COLOR_SCHEMES, COLOR_SCHEME_TRAIT, COLOR_SCHEME_TYPES, ColorScheme, DEFAULT_FLAVOR_ID, DESIGN_TOKEN_GROUPS, DESIGN_TOKEN_TIERS, DESIGN_TOKEN_TYPES, DesignConfigKey, ELEMENT_STYLES, ELEMENT_STYLE_MARKER_CLASS, ELEMENT_STYLE_STATES, EMPTY_IMAGE_ATTRIBUTE, EMPTY_IMAGE_SRC, ElementStyleState, FLAVOR_SPEC_VERSION, FONT_CATALOG, FONT_FAMILY_TOKENS, FONT_FILE_ACCEPT, FONT_FILE_EXTENSIONS, FONT_FILE_FORMATS, FONT_STYLES, FONT_WEIGHTS, FontUploadError, GOOGLE_FONTS_CSS_ORIGIN, GOOGLE_FONTS_FILE_ORIGIN, MAX_FONT_FILE_BYTES, NEW_NODE_STYLE_DEFAULTS, OwnedTraitLink, PALETTE_PRESETS, PRE_DS2_FLAVOR_DEFAULTS, REDUCED_MOTION_OVERRIDES, REDUCED_TRANSPARENCY_OVERRIDES, REVERT_WINDOW_MS, SPEC_A11Y, SPEC_AXES, SPEC_BUTTON_VARIANT_TO_STYLE, SPEC_CONTRAST, SPEC_DEFAULT_ELEMENT_STYLE, SPEC_ELEMENT_STYLES, SPEC_FIELD_CLASS_BASELINE, SPEC_FLAVORS, SPEC_FLAVOR_PACKS, SPEC_FONTS, SPEC_FONT_ROLES, SPEC_LEGACY_ALIASES, SPEC_PALETTE_PRESETS, SPEC_SCHEMES, SPEC_SPRINGS, SPEC_TIERS, SPEC_TIER_IDS, SPEC_TOKEN_TYPES, SUPERSEDED_STYLE_VALUES, SWISS_FLAVOR, USER_TOKEN_SOURCE, WCAG_AA_TEXT, adoptElementStyles, adoptionStyleFor, apcaLc, applyElementStyle, applyHeadingLevelRule, buildFlavorTokens, buildFontFaceCss, catalogFontId, checkFontWeight, choicesForPack, colorSchemeClass, colorSchemeOf, compareFontWeights, compileSchemeCss, compileTokenCss, compileTokenCssBlocks, cssString, defaultDesignChoices, defaultElementStyleFor, deriveAccentTokens, deriveBrandTokens, designBaseline, designConfigEntries, designModeOf, designTokenRepairs, designTokenRows, elementStyleById, elementStyleClass, elementStylesFor, emptyImageLabelSrc, emptyImagePlaceholder, emptyImageSrc, flavorPackById, flavorSeedWrites, flavorSourceStamp, fontFamilyKey, fontFileName, fontFileStem, fontFormatOf, fontPreloads, fontRoleReferences, fontStackWithout, fontWeightCovers, fontWeightRange, fontWeightValue, fontsForTokens, formatFontFamilies, formatFontFamily, formatFontWeight, googleFontHref, groupFontFamilies, hasElementStyleMarker, isDesignTokenGroup, isDesignTokenTier, isDesignTokenType, isFontWeightRange, isRetiredFlavorId, legacyRuleTokenReferences, matchFontWeight, missingDesignRows, missingFontRoles, nodeDesignClasses, normalizeFontStyle, normalizeFontWeight, normalizeFontWeightValue, oklabToRgb, ownedTraitStatus, ownedTraitsOf, packDesignChoices, parseFontFamilies, parseFontWeight, parseHexColor, planDesignApply, planDesignRevert, planFlavorRevert, planFlavorSeed, planFontFamilyRemoval, planSwissMigration, previewElementStyleAdoption, previewFontWeight, readDesignConfig, readOwnedTrait, relativeLuminance, resolveDesignChoices, resolveTokenReferences, resolveTokenValues, revertAvailable, rgbToOklab, sameDesignChoices, specTokenNames, springToLinear, stackNamesFamily, styleKeyToKebab, switchElementStyle, syncNodeDesignClasses, toHexColor, tokenReferences, tokensToDarkVarMap, tokensToVarMap, unknownTokenReferences, untouchedSeedRow, userFontStack, validateFlavorPack, wcagContrastRatio, writeOwnedTrait };
 //# sourceMappingURL=vectoriox-iox-ui-design-core.mjs.map