@variance-authority/core 0.1.0

package/dist/rules/normalize/project.d.ts

@@ -0,0 +1,42 @@
+import type { CanonicalValue } from '../../format/canonical.js';
+import type { IgnoreSite, SemanticNode } from '../../format/snapshot.js';
+/**
+ * What a finished tree projects into.
+ *
+ * Three walks over the same normalized tree, each producing something the
+ * snapshot carries: two hash inputs and one list. They sit together because the
+ * relationship between them is the interesting part — **what a projection omits
+ * is a decision**, and reading them side by side is the only way to check that
+ * the decisions still line up.
+ *
+ * The projections are explicit field lists rather than "the node minus some
+ * keys", and that is load-bearing rather than stylistic. A field added to
+ * `SemanticNode` must be *chosen* into a hash by someone editing this file; the
+ * subtractive form would have swept `ignoredBy` into the structure hash the day
+ * it was added, and every subject carrying an ignore would have re-baselined.
+ */
+/**
+ * Structure alone: shape, roles, names, descriptions, states, admitted
+ * attributes, text.
+ *
+ * Hashed separately from style so the docket can say *which* held. "The DOM is
+ * identical, only styling moved" is the sentence that turns a diff into a
+ * token-band root instead of a structural review.
+ */
+export declare function structureOf(node: SemanticNode): CanonicalValue;
+export declare function styleOf(node: SemanticNode, includeLayout: boolean): CanonicalValue;
+/**
+ * Every excluded subtree in the finished tree, outermost first (spec 0024).
+ *
+ * Read from the *finished* tree rather than recorded during the walk, because
+ * wrapper collapse re-paths whole subtrees: a path taken on the way down names a
+ * node that may not be there on the way out, and an ignore that quietly slid one
+ * level up absorbs a sibling nobody excluded.
+ *
+ * Nested marks are kept rather than collapsed. Two rules can reach the same
+ * subtree, and the register has to be able to say which of them absorbed what;
+ * the cost is a duplicate site absorbing the same deltas under two names, which
+ * shows up in the register, where it belongs.
+ */
+export declare function sitesIn(root: SemanticNode): readonly IgnoreSite[];
+//# sourceMappingURL=project.d.ts.map

package/dist/rules/normalize/project.js

@@ -0,0 +1,83 @@
+/**
+ * What a finished tree projects into.
+ *
+ * Three walks over the same normalized tree, each producing something the
+ * snapshot carries: two hash inputs and one list. They sit together because the
+ * relationship between them is the interesting part — **what a projection omits
+ * is a decision**, and reading them side by side is the only way to check that
+ * the decisions still line up.
+ *
+ * The projections are explicit field lists rather than "the node minus some
+ * keys", and that is load-bearing rather than stylistic. A field added to
+ * `SemanticNode` must be *chosen* into a hash by someone editing this file; the
+ * subtractive form would have swept `ignoredBy` into the structure hash the day
+ * it was added, and every subject carrying an ignore would have re-baselined.
+ */
+/**
+ * Structure alone: shape, roles, names, descriptions, states, admitted
+ * attributes, text.
+ *
+ * Hashed separately from style so the docket can say *which* held. "The DOM is
+ * identical, only styling moved" is the sentence that turns a diff into a
+ * token-band root instead of a structural review.
+ */
+export function structureOf(node) {
+    return {
+        tag: node.tag,
+        alias: node.alias,
+        portalled: node.portalled,
+        role: node.role,
+        name: node.name,
+        description: node.description,
+        state: node.state,
+        attributes: node.attributes,
+        text: node.text,
+        children: node.children.map(structureOf),
+    };
+}
+export function styleOf(node, includeLayout) {
+    const entries = [];
+    const visit = (current) => {
+        entries.push({
+            path: current.path,
+            style: current.style,
+            tokens: current.tokens,
+            // Absent, never zeroed, under a profile without layout (ADR-0002).
+            rect: includeLayout && current.rect ? { ...current.rect } : undefined,
+        });
+        for (const child of current.children)
+            visit(child);
+    };
+    visit(node);
+    return entries;
+}
+/**
+ * Every excluded subtree in the finished tree, outermost first (spec 0024).
+ *
+ * Read from the *finished* tree rather than recorded during the walk, because
+ * wrapper collapse re-paths whole subtrees: a path taken on the way down names a
+ * node that may not be there on the way out, and an ignore that quietly slid one
+ * level up absorbs a sibling nobody excluded.
+ *
+ * Nested marks are kept rather than collapsed. Two rules can reach the same
+ * subtree, and the register has to be able to say which of them absorbed what;
+ * the cost is a duplicate site absorbing the same deltas under two names, which
+ * shows up in the register, where it belongs.
+ */
+export function sitesIn(root) {
+    const sites = [];
+    const visit = (node) => {
+        for (const rule of node.ignoredBy ?? []) {
+            sites.push({
+                path: node.path,
+                rule,
+                ...(node.rect ? { rect: node.rect } : {}),
+            });
+        }
+        for (const child of node.children)
+            visit(child);
+    };
+    visit(root);
+    return sites;
+}
+//# sourceMappingURL=project.js.map

package/dist/rules/normalize/project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../../../src/rules/normalize/project.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;GAcG;AAEH;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CAAC,IAAkB;IAC5C,OAAO;QACL,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,KAAK,EAAE,IAAI,CAAC,KAAmC;QAC/C,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC;KACzC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,IAAkB,EAAE,aAAsB;IAChE,MAAM,OAAO,GAAqB,EAAE,CAAC;IAErC,MAAM,KAAK,GAAG,CAAC,OAAqB,EAAQ,EAAE;QAC5C,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,mEAAmE;YACnE,IAAI,EAAE,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS;SACtE,CAAC,CAAC;QACH,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,QAAQ;YAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IACrD,CAAC,CAAC;IAEF,KAAK,CAAC,IAAI,CAAC,CAAC;IACZ,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,OAAO,CAAC,IAAkB;IACxC,MAAM,KAAK,GAAiB,EAAE,CAAC;IAE/B,MAAM,KAAK,GAAG,CAAC,IAAkB,EAAQ,EAAE;QACzC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,SAAS,IAAI,EAAE,EAAE,CAAC;YACxC,KAAK,CAAC,IAAI,CAAC;gBACT,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,IAAI;gBACJ,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC1C,CAAC,CAAC;QACL,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ;YAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IAClD,CAAC,CAAC;IAEF,KAAK,CAAC,IAAI,CAAC,CAAC;IACZ,OAAO,KAAK,CAAC;AACf,CAAC","sourcesContent":["import type { CanonicalValue } from '../../format/canonical.js';\nimport type { IgnoreSite, SemanticNode } from '../../format/snapshot.js';\n\n/**\n * What a finished tree projects into.\n *\n * Three walks over the same normalized tree, each producing something the\n * snapshot carries: two hash inputs and one list. They sit together because the\n * relationship between them is the interesting part — **what a projection omits\n * is a decision**, and reading them side by side is the only way to check that\n * the decisions still line up.\n *\n * The projections are explicit field lists rather than \"the node minus some\n * keys\", and that is load-bearing rather than stylistic. A field added to\n * `SemanticNode` must be *chosen* into a hash by someone editing this file; the\n * subtractive form would have swept `ignoredBy` into the structure hash the day\n * it was added, and every subject carrying an ignore would have re-baselined.\n */\n\n/**\n * Structure alone: shape, roles, names, descriptions, states, admitted\n * attributes, text.\n *\n * Hashed separately from style so the docket can say *which* held. \"The DOM is\n * identical, only styling moved\" is the sentence that turns a diff into a\n * token-band root instead of a structural review.\n */\nexport function structureOf(node: SemanticNode): CanonicalValue {\n  return {\n    tag: node.tag,\n    alias: node.alias,\n    portalled: node.portalled,\n    role: node.role,\n    name: node.name,\n    description: node.description,\n    state: node.state as CanonicalValue | undefined,\n    attributes: node.attributes,\n    text: node.text,\n    children: node.children.map(structureOf),\n  };\n}\n\nexport function styleOf(node: SemanticNode, includeLayout: boolean): CanonicalValue {\n  const entries: CanonicalValue[] = [];\n\n  const visit = (current: SemanticNode): void => {\n    entries.push({\n      path: current.path,\n      style: current.style,\n      tokens: current.tokens,\n      // Absent, never zeroed, under a profile without layout (ADR-0002).\n      rect: includeLayout && current.rect ? { ...current.rect } : undefined,\n    });\n    for (const child of current.children) visit(child);\n  };\n\n  visit(node);\n  return entries;\n}\n\n/**\n * Every excluded subtree in the finished tree, outermost first (spec 0024).\n *\n * Read from the *finished* tree rather than recorded during the walk, because\n * wrapper collapse re-paths whole subtrees: a path taken on the way down names a\n * node that may not be there on the way out, and an ignore that quietly slid one\n * level up absorbs a sibling nobody excluded.\n *\n * Nested marks are kept rather than collapsed. Two rules can reach the same\n * subtree, and the register has to be able to say which of them absorbed what;\n * the cost is a duplicate site absorbing the same deltas under two names, which\n * shows up in the register, where it belongs.\n */\nexport function sitesIn(root: SemanticNode): readonly IgnoreSite[] {\n  const sites: IgnoreSite[] = [];\n\n  const visit = (node: SemanticNode): void => {\n    for (const rule of node.ignoredBy ?? []) {\n      sites.push({\n        path: node.path,\n        rule,\n        ...(node.rect ? { rect: node.rect } : {}),\n      });\n    }\n    for (const child of node.children) visit(child);\n  };\n\n  visit(root);\n  return sites;\n}\n"]}

package/dist/rules/normalize/shorthand.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Shorthand expansion.
+ *
+ * The allowlist holds longhands only, so `margin: 4px` and
+ * `margin-top: 4px; margin-right: 4px; …` must reduce to the same snapshot.
+ * Without that, splitting a shorthand during a refactor — a change no user can
+ * perceive — would invalidate every baseline it touches.
+ *
+ * The safety rule throughout: **an expansion we are not sure of is not
+ * performed.** {@link expandDeclaration} returns `confident: false` and hands
+ * back the shorthand unchanged, which the projection step then admits under its
+ * own name. A partially-expanded shorthand would drop the components it failed
+ * to classify, and a dropped declaration is a value missing from the hash — a
+ * false `unchanged`. Keeping an un-normalized value costs at most a review
+ * nobody needed; dropping one costs a missed regression.
+ */
+export interface Expansion {
+    readonly declarations: readonly {
+        readonly property: string;
+        readonly value: string;
+    }[];
+    /**
+     * `false` when the shorthand could not be decomposed with certainty. The
+     * single returned declaration is then the original shorthand.
+     */
+    readonly confident: boolean;
+}
+/** Shorthands admitted under their own name when expansion is not confident. */
+export declare const SHORTHAND_PROPERTIES: readonly string[];
+export declare function expandDeclaration(property: string, value: string): Expansion;
+/**
+ * Split on whitespace, but never inside a function call.
+ *
+ * `margin: calc(1px + 2px) 0` is two values, not four. Splitting naively would
+ * silently corrupt every `calc()`, `var()`, and gradient in the corpus.
+ */
+export declare function topLevelParts(value: string): string[];
+//# sourceMappingURL=shorthand.d.ts.map

package/dist/rules/normalize/shorthand.js

@@ -0,0 +1,388 @@
+import { parseColor } from './color.js';
+/** Shorthands admitted under their own name when expansion is not confident. */
+export const SHORTHAND_PROPERTIES = [
+    'margin', 'padding', 'inset', 'gap', 'overflow',
+    'border', 'border-width', 'border-style', 'border-color', 'border-radius',
+    'border-top', 'border-right', 'border-bottom', 'border-left',
+    'outline', 'flex', 'flex-flow', 'place-items', 'place-content', 'place-self',
+    'grid-row', 'grid-column', 'grid-area', 'text-decoration', 'background', 'font',
+];
+const SIDES = ['top', 'right', 'bottom', 'left'];
+const CORNERS = [
+    'border-top-left-radius', 'border-top-right-radius',
+    'border-bottom-right-radius', 'border-bottom-left-radius',
+];
+const LINE_STYLES = new Set([
+    'none', 'hidden', 'dotted', 'dashed', 'solid', 'double',
+    'groove', 'ridge', 'inset', 'outset',
+]);
+const LINE_WIDTHS = new Set(['thin', 'medium', 'thick']);
+export function expandDeclaration(property, value) {
+    const expand = EXPANDERS[property];
+    if (!expand)
+        return { declarations: [{ property, value }], confident: true };
+    const expanded = expand(value.trim());
+    return expanded ?? { declarations: [{ property, value }], confident: false };
+}
+const EXPANDERS = {
+    margin: (v) => box(v, (side) => `margin-${side}`),
+    padding: (v) => box(v, (side) => `padding-${side}`),
+    inset: (v) => box(v, (side) => side),
+    'border-width': (v) => box(v, (side) => `border-${side}-width`),
+    'border-style': (v) => box(v, (side) => `border-${side}-style`),
+    'border-color': (v) => box(v, (side) => `border-${side}-color`),
+    'scroll-margin': (v) => box(v, (side) => `scroll-margin-${side}`),
+    'scroll-padding': (v) => box(v, (side) => `scroll-padding-${side}`),
+    gap: (v) => pair(v, 'row-gap', 'column-gap'),
+    overflow: (v) => pair(v, 'overflow-x', 'overflow-y'),
+    'place-items': (v) => pair(v, 'align-items', 'justify-items'),
+    'place-content': (v) => pair(v, 'align-content', 'justify-content'),
+    'place-self': (v) => pair(v, 'align-self', 'justify-self'),
+    'grid-row': (v) => slash(v, 'grid-row-start', 'grid-row-end'),
+    'grid-column': (v) => slash(v, 'grid-column-start', 'grid-column-end'),
+    'border-radius': expandBorderRadius,
+    border: (v) => expandBorderSides(v, SIDES),
+    'border-top': (v) => expandBorderSides(v, ['top']),
+    'border-right': (v) => expandBorderSides(v, ['right']),
+    'border-bottom': (v) => expandBorderSides(v, ['bottom']),
+    'border-left': (v) => expandBorderSides(v, ['left']),
+    outline: expandOutline,
+    flex: expandFlex,
+    'flex-flow': expandFlexFlow,
+    'text-decoration': expandTextDecoration,
+    // `background` and `font` are the two shorthands whose grammars are genuinely
+    // ambiguous to decompose (a bare `<length>` in `background` may be a position
+    // or a size; `font` interleaves four optional keyword slots before a required
+    // size). Both are declared unexpandable rather than guessed at — see the
+    // safety rule above. Under a profile with computed style the engine has
+    // already resolved them into longhands, so this only affects the declared-only
+    // tier, where an un-normalized value is a correct description of what is known.
+    background: () => null,
+    font: () => null,
+};
+/** 1–4 values in top/right/bottom/left order, per the CSS box grammar. */
+function box(value, name) {
+    const parts = topLevelParts(value);
+    if (parts.length === 0 || parts.length > 4)
+        return null;
+    if (parts.some(isGlobalKeywordAmbiguity))
+        return null;
+    const [a, b = a, c = a, d = b] = parts;
+    const resolved = [a, b, c, d];
+    return {
+        declarations: SIDES.map((side, index) => ({
+            property: name(side),
+            value: resolved[index],
+        })),
+        confident: true,
+    };
+}
+function pair(value, first, second) {
+    const parts = topLevelParts(value);
+    if (parts.length === 0 || parts.length > 2)
+        return null;
+    const a = parts[0];
+    const b = parts[1] ?? a;
+    return {
+        declarations: [
+            { property: first, value: a },
+            { property: second, value: b },
+        ],
+        confident: true,
+    };
+}
+function slash(value, start, end) {
+    const parts = value.split('/').map((part) => part.trim());
+    if (parts.length > 2)
+        return null;
+    const a = parts[0];
+    // Omitted end defaults to `auto`, not to a copy of start, except for a
+    // custom-ident line name — where it does copy. Ambiguous, so decline.
+    if (parts.length === 1) {
+        if (/^-?[a-z_]/i.test(a) && !/^(auto|span)\b/i.test(a))
+            return null;
+        return {
+            declarations: [
+                { property: start, value: a },
+                { property: end, value: 'auto' },
+            ],
+            confident: true,
+        };
+    }
+    return {
+        declarations: [
+            { property: start, value: a },
+            { property: end, value: parts[1] },
+        ],
+        confident: true,
+    };
+}
+/** `border-radius: a b / c d` — the `/` separates horizontal from vertical radii. */
+function expandBorderRadius(value) {
+    const [horizontal, vertical] = value.split('/').map((part) => part.trim());
+    const h = cornerValues(horizontal ?? '');
+    if (!h)
+        return null;
+    if (vertical === undefined) {
+        return {
+            declarations: CORNERS.map((property, index) => ({ property, value: h[index] })),
+            confident: true,
+        };
+    }
+    const v = cornerValues(vertical);
+    if (!v)
+        return null;
+    return {
+        declarations: CORNERS.map((property, index) => ({
+            property,
+            value: `${h[index]} ${v[index]}`,
+        })),
+        confident: true,
+    };
+}
+/** Corner order is TL, TR, BR, BL — different from the box order. */
+function cornerValues(value) {
+    const parts = topLevelParts(value);
+    if (parts.length === 0 || parts.length > 4)
+        return null;
+    const [a, b = a, c = a, d = b] = parts;
+    return [a, b, c, d];
+}
+function expandBorderSides(value, sides) {
+    const parsed = classifyLineComponents(value);
+    if (!parsed)
+        return null;
+    const declarations = sides.flatMap((side) => [
+        { property: `border-${side}-width`, value: parsed.width },
+        { property: `border-${side}-style`, value: parsed.style },
+        { property: `border-${side}-color`, value: parsed.color },
+    ]);
+    return { declarations, confident: true };
+}
+function expandOutline(value) {
+    const parsed = classifyLineComponents(value);
+    if (!parsed)
+        return null;
+    return {
+        declarations: [
+            { property: 'outline-width', value: parsed.width },
+            { property: 'outline-style', value: parsed.style },
+            { property: 'outline-color', value: parsed.color },
+        ],
+        confident: true,
+    };
+}
+/**
+ * Split `<width> || <style> || <color>`, which may appear in any order.
+ *
+ * Omitted components take their initial values rather than being left out —
+ * `border: solid` really does reset width and colour, and recording only the
+ * style would let a genuine colour change slip through as unobserved.
+ */
+function classifyLineComponents(value) {
+    const parts = topLevelParts(value);
+    if (parts.length === 0 || parts.length > 3)
+        return null;
+    let width;
+    let style;
+    let color;
+    for (const part of parts) {
+        const lower = part.toLowerCase();
+        if (LINE_STYLES.has(lower)) {
+            if (style !== undefined)
+                return null;
+            style = lower;
+        }
+        else if (LINE_WIDTHS.has(lower) || isLength(part)) {
+            if (width !== undefined)
+                return null;
+            width = part;
+        }
+        else if (lower === 'currentcolor' || parseColor(part) !== null || part.startsWith('var(')) {
+            if (color !== undefined)
+                return null;
+            color = part;
+        }
+        else {
+            return null;
+        }
+    }
+    return {
+        width: width ?? 'medium',
+        style: style ?? 'none',
+        color: color ?? 'currentcolor',
+    };
+}
+/** `flex: <grow> <shrink>? <basis>?`, plus the `none`/`auto`/`initial` keywords. */
+function expandFlex(value) {
+    const lower = value.toLowerCase().trim();
+    const keyword = {
+        none: ['0', '0', 'auto'],
+        auto: ['1', '1', 'auto'],
+        initial: ['0', '1', 'auto'],
+    };
+    const preset = keyword[lower];
+    const [grow, shrink, basis] = preset ?? classifyFlexParts(topLevelParts(value)) ?? [];
+    if (grow === undefined || shrink === undefined || basis === undefined)
+        return null;
+    return {
+        declarations: [
+            { property: 'flex-grow', value: grow },
+            { property: 'flex-shrink', value: shrink },
+            { property: 'flex-basis', value: basis },
+        ],
+        confident: true,
+    };
+}
+/**
+ * A single number is `flex-grow`; a single length is `flex-basis`. The
+ * one-value form is the only place the two are distinguishable at all, which is
+ * why the split happens here rather than positionally.
+ */
+function classifyFlexParts(parts) {
+    if (parts.length === 1) {
+        const only = parts[0];
+        if (isBareNumber(only))
+            return [only, '1', '0%'];
+        if (isLength(only) || only === 'auto' || only === 'content')
+            return ['1', '1', only];
+        return null;
+    }
+    if (parts.length === 2) {
+        const [first, second] = parts;
+        if (!isBareNumber(first))
+            return null;
+        if (isBareNumber(second))
+            return [first, second, '0%'];
+        return [first, '1', second];
+    }
+    if (parts.length === 3) {
+        const [grow, shrink, basis] = parts;
+        if (!isBareNumber(grow) || !isBareNumber(shrink))
+            return null;
+        return [grow, shrink, basis];
+    }
+    return null;
+}
+function expandFlexFlow(value) {
+    const parts = topLevelParts(value);
+    if (parts.length === 0 || parts.length > 2)
+        return null;
+    const wraps = new Set(['nowrap', 'wrap', 'wrap-reverse']);
+    const directions = new Set(['row', 'row-reverse', 'column', 'column-reverse']);
+    let direction;
+    let wrap;
+    for (const part of parts) {
+        const lower = part.toLowerCase();
+        if (directions.has(lower)) {
+            if (direction !== undefined)
+                return null;
+            direction = lower;
+        }
+        else if (wraps.has(lower)) {
+            if (wrap !== undefined)
+                return null;
+            wrap = lower;
+        }
+        else {
+            return null;
+        }
+    }
+    return {
+        declarations: [
+            { property: 'flex-direction', value: direction ?? 'row' },
+            { property: 'flex-wrap', value: wrap ?? 'nowrap' },
+        ],
+        confident: true,
+    };
+}
+function expandTextDecoration(value) {
+    const parts = topLevelParts(value);
+    if (parts.length === 0 || parts.length > 4)
+        return null;
+    const lines = new Set(['none', 'underline', 'overline', 'line-through', 'blink']);
+    const styles = new Set(['solid', 'double', 'dotted', 'dashed', 'wavy']);
+    const lineParts = [];
+    let style;
+    let color;
+    let thickness;
+    for (const part of parts) {
+        const lower = part.toLowerCase();
+        if (lines.has(lower))
+            lineParts.push(lower);
+        else if (styles.has(lower)) {
+            if (style !== undefined)
+                return null;
+            style = lower;
+        }
+        else if (lower === 'auto' || lower === 'from-font' || isLength(part)) {
+            if (thickness !== undefined)
+                return null;
+            thickness = part;
+        }
+        else if (lower === 'currentcolor' || parseColor(part) !== null || part.startsWith('var(')) {
+            if (color !== undefined)
+                return null;
+            color = part;
+        }
+        else {
+            return null;
+        }
+    }
+    return {
+        declarations: [
+            { property: 'text-decoration-line', value: lineParts.length > 0 ? lineParts.join(' ') : 'none' },
+            { property: 'text-decoration-style', value: style ?? 'solid' },
+            { property: 'text-decoration-color', value: color ?? 'currentcolor' },
+            { property: 'text-decoration-thickness', value: thickness ?? 'auto' },
+        ],
+        confident: true,
+    };
+}
+/**
+ * Split on whitespace, but never inside a function call.
+ *
+ * `margin: calc(1px + 2px) 0` is two values, not four. Splitting naively would
+ * silently corrupt every `calc()`, `var()`, and gradient in the corpus.
+ */
+export function topLevelParts(value) {
+    const parts = [];
+    let depth = 0;
+    let current = '';
+    for (const char of value.trim()) {
+        if (char === '(')
+            depth += 1;
+        else if (char === ')')
+            depth -= 1;
+        if (depth === 0 && /\s/.test(char)) {
+            if (current.length > 0)
+                parts.push(current);
+            current = '';
+            continue;
+        }
+        current += char;
+    }
+    if (current.length > 0)
+        parts.push(current);
+    return parts;
+}
+/**
+ * `inherit`, `initial`, `unset`, `revert`, and any `var()` reference are
+ * indivisible: they apply to the whole shorthand and cannot be distributed to
+ * longhands without resolving them first.
+ */
+function isGlobalKeywordAmbiguity(part) {
+    const lower = part.toLowerCase();
+    return (lower === 'inherit' ||
+        lower === 'initial' ||
+        lower === 'unset' ||
+        lower === 'revert' ||
+        lower === 'revert-layer');
+}
+function isLength(part) {
+    return /^[+-]?(\d+\.?\d*|\.\d+)([a-z]+|%)?$/i.test(part) || part.toLowerCase().startsWith('calc(');
+}
+function isBareNumber(part) {
+    return /^[+-]?(\d+\.?\d*|\.\d+)$/.test(part);
+}
+//# sourceMappingURL=shorthand.js.map

package/dist/rules/normalize/shorthand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shorthand.js","sourceRoot":"","sources":["../../../src/rules/normalize/shorthand.ts"],"names":[],"mappings":"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","sourcesContent":["import { parseColor } from './color.js';\n\n/**\n * Shorthand expansion.\n *\n * The allowlist holds longhands only, so `margin: 4px` and\n * `margin-top: 4px; margin-right: 4px; …` must reduce to the same snapshot.\n * Without that, splitting a shorthand during a refactor — a change no user can\n * perceive — would invalidate every baseline it touches.\n *\n * The safety rule throughout: **an expansion we are not sure of is not\n * performed.** {@link expandDeclaration} returns `confident: false` and hands\n * back the shorthand unchanged, which the projection step then admits under its\n * own name. A partially-expanded shorthand would drop the components it failed\n * to classify, and a dropped declaration is a value missing from the hash — a\n * false `unchanged`. Keeping an un-normalized value costs at most a review\n * nobody needed; dropping one costs a missed regression.\n */\n\nexport interface Expansion {\n  readonly declarations: readonly { readonly property: string; readonly value: string }[];\n  /**\n   * `false` when the shorthand could not be decomposed with certainty. The\n   * single returned declaration is then the original shorthand.\n   */\n  readonly confident: boolean;\n}\n\n/** Shorthands admitted under their own name when expansion is not confident. */\nexport const SHORTHAND_PROPERTIES: readonly string[] = [\n  'margin', 'padding', 'inset', 'gap', 'overflow',\n  'border', 'border-width', 'border-style', 'border-color', 'border-radius',\n  'border-top', 'border-right', 'border-bottom', 'border-left',\n  'outline', 'flex', 'flex-flow', 'place-items', 'place-content', 'place-self',\n  'grid-row', 'grid-column', 'grid-area', 'text-decoration', 'background', 'font',\n];\n\nconst SIDES = ['top', 'right', 'bottom', 'left'] as const;\n\nconst CORNERS = [\n  'border-top-left-radius', 'border-top-right-radius',\n  'border-bottom-right-radius', 'border-bottom-left-radius',\n] as const;\n\nconst LINE_STYLES = new Set([\n  'none', 'hidden', 'dotted', 'dashed', 'solid', 'double',\n  'groove', 'ridge', 'inset', 'outset',\n]);\n\nconst LINE_WIDTHS = new Set(['thin', 'medium', 'thick']);\n\nexport function expandDeclaration(property: string, value: string): Expansion {\n  const expand = EXPANDERS[property];\n  if (!expand) return { declarations: [{ property, value }], confident: true };\n\n  const expanded = expand(value.trim());\n  return expanded ?? { declarations: [{ property, value }], confident: false };\n}\n\ntype Expander = (value: string) => Expansion | null;\n\nconst EXPANDERS: Readonly<Record<string, Expander>> = {\n  margin: (v) => box(v, (side) => `margin-${side}`),\n  padding: (v) => box(v, (side) => `padding-${side}`),\n  inset: (v) => box(v, (side) => side),\n  'border-width': (v) => box(v, (side) => `border-${side}-width`),\n  'border-style': (v) => box(v, (side) => `border-${side}-style`),\n  'border-color': (v) => box(v, (side) => `border-${side}-color`),\n  'scroll-margin': (v) => box(v, (side) => `scroll-margin-${side}`),\n  'scroll-padding': (v) => box(v, (side) => `scroll-padding-${side}`),\n\n  gap: (v) => pair(v, 'row-gap', 'column-gap'),\n  overflow: (v) => pair(v, 'overflow-x', 'overflow-y'),\n  'place-items': (v) => pair(v, 'align-items', 'justify-items'),\n  'place-content': (v) => pair(v, 'align-content', 'justify-content'),\n  'place-self': (v) => pair(v, 'align-self', 'justify-self'),\n\n  'grid-row': (v) => slash(v, 'grid-row-start', 'grid-row-end'),\n  'grid-column': (v) => slash(v, 'grid-column-start', 'grid-column-end'),\n\n  'border-radius': expandBorderRadius,\n  border: (v) => expandBorderSides(v, SIDES),\n  'border-top': (v) => expandBorderSides(v, ['top']),\n  'border-right': (v) => expandBorderSides(v, ['right']),\n  'border-bottom': (v) => expandBorderSides(v, ['bottom']),\n  'border-left': (v) => expandBorderSides(v, ['left']),\n  outline: expandOutline,\n  flex: expandFlex,\n  'flex-flow': expandFlexFlow,\n  'text-decoration': expandTextDecoration,\n\n  // `background` and `font` are the two shorthands whose grammars are genuinely\n  // ambiguous to decompose (a bare `<length>` in `background` may be a position\n  // or a size; `font` interleaves four optional keyword slots before a required\n  // size). Both are declared unexpandable rather than guessed at — see the\n  // safety rule above. Under a profile with computed style the engine has\n  // already resolved them into longhands, so this only affects the declared-only\n  // tier, where an un-normalized value is a correct description of what is known.\n  background: () => null,\n  font: () => null,\n};\n\n/** 1–4 values in top/right/bottom/left order, per the CSS box grammar. */\nfunction box(value: string, name: (side: string) => string): Expansion | null {\n  const parts = topLevelParts(value);\n  if (parts.length === 0 || parts.length > 4) return null;\n  if (parts.some(isGlobalKeywordAmbiguity)) return null;\n\n  const [a, b = a, c = a, d = b] = parts as [string, string?, string?, string?];\n  const resolved = [a, b, c, d] as const;\n\n  return {\n    declarations: SIDES.map((side, index) => ({\n      property: name(side),\n      value: resolved[index]!,\n    })),\n    confident: true,\n  };\n}\n\nfunction pair(value: string, first: string, second: string): Expansion | null {\n  const parts = topLevelParts(value);\n  if (parts.length === 0 || parts.length > 2) return null;\n\n  const a = parts[0]!;\n  const b = parts[1] ?? a;\n  return {\n    declarations: [\n      { property: first, value: a },\n      { property: second, value: b },\n    ],\n    confident: true,\n  };\n}\n\nfunction slash(value: string, start: string, end: string): Expansion | null {\n  const parts = value.split('/').map((part) => part.trim());\n  if (parts.length > 2) return null;\n\n  const a = parts[0]!;\n  // Omitted end defaults to `auto`, not to a copy of start, except for a\n  // custom-ident line name — where it does copy. Ambiguous, so decline.\n  if (parts.length === 1) {\n    if (/^-?[a-z_]/i.test(a) && !/^(auto|span)\\b/i.test(a)) return null;\n    return {\n      declarations: [\n        { property: start, value: a },\n        { property: end, value: 'auto' },\n      ],\n      confident: true,\n    };\n  }\n\n  return {\n    declarations: [\n      { property: start, value: a },\n      { property: end, value: parts[1]! },\n    ],\n    confident: true,\n  };\n}\n\n/** `border-radius: a b / c d` — the `/` separates horizontal from vertical radii. */\nfunction expandBorderRadius(value: string): Expansion | null {\n  const [horizontal, vertical] = value.split('/').map((part) => part.trim());\n\n  const h = cornerValues(horizontal ?? '');\n  if (!h) return null;\n\n  if (vertical === undefined) {\n    return {\n      declarations: CORNERS.map((property, index) => ({ property, value: h[index]! })),\n      confident: true,\n    };\n  }\n\n  const v = cornerValues(vertical);\n  if (!v) return null;\n\n  return {\n    declarations: CORNERS.map((property, index) => ({\n      property,\n      value: `${h[index]!} ${v[index]!}`,\n    })),\n    confident: true,\n  };\n}\n\n/** Corner order is TL, TR, BR, BL — different from the box order. */\nfunction cornerValues(value: string): readonly [string, string, string, string] | null {\n  const parts = topLevelParts(value);\n  if (parts.length === 0 || parts.length > 4) return null;\n\n  const [a, b = a, c = a, d = b] = parts as [string, string?, string?, string?];\n  return [a, b, c, d];\n}\n\nfunction expandBorderSides(value: string, sides: readonly string[]): Expansion | null {\n  const parsed = classifyLineComponents(value);\n  if (!parsed) return null;\n\n  const declarations = sides.flatMap((side) => [\n    { property: `border-${side}-width`, value: parsed.width },\n    { property: `border-${side}-style`, value: parsed.style },\n    { property: `border-${side}-color`, value: parsed.color },\n  ]);\n\n  return { declarations, confident: true };\n}\n\nfunction expandOutline(value: string): Expansion | null {\n  const parsed = classifyLineComponents(value);\n  if (!parsed) return null;\n\n  return {\n    declarations: [\n      { property: 'outline-width', value: parsed.width },\n      { property: 'outline-style', value: parsed.style },\n      { property: 'outline-color', value: parsed.color },\n    ],\n    confident: true,\n  };\n}\n\n/**\n * Split `<width> || <style> || <color>`, which may appear in any order.\n *\n * Omitted components take their initial values rather than being left out —\n * `border: solid` really does reset width and colour, and recording only the\n * style would let a genuine colour change slip through as unobserved.\n */\nfunction classifyLineComponents(\n  value: string,\n): { width: string; style: string; color: string } | null {\n  const parts = topLevelParts(value);\n  if (parts.length === 0 || parts.length > 3) return null;\n\n  let width: string | undefined;\n  let style: string | undefined;\n  let color: string | undefined;\n\n  for (const part of parts) {\n    const lower = part.toLowerCase();\n\n    if (LINE_STYLES.has(lower)) {\n      if (style !== undefined) return null;\n      style = lower;\n    } else if (LINE_WIDTHS.has(lower) || isLength(part)) {\n      if (width !== undefined) return null;\n      width = part;\n    } else if (lower === 'currentcolor' || parseColor(part) !== null || part.startsWith('var(')) {\n      if (color !== undefined) return null;\n      color = part;\n    } else {\n      return null;\n    }\n  }\n\n  return {\n    width: width ?? 'medium',\n    style: style ?? 'none',\n    color: color ?? 'currentcolor',\n  };\n}\n\n/** `flex: <grow> <shrink>? <basis>?`, plus the `none`/`auto`/`initial` keywords. */\nfunction expandFlex(value: string): Expansion | null {\n  const lower = value.toLowerCase().trim();\n  const keyword: Readonly<Record<string, readonly [string, string, string]>> = {\n    none: ['0', '0', 'auto'],\n    auto: ['1', '1', 'auto'],\n    initial: ['0', '1', 'auto'],\n  };\n\n  const preset = keyword[lower];\n  const [grow, shrink, basis] = preset ?? classifyFlexParts(topLevelParts(value)) ?? [];\n  if (grow === undefined || shrink === undefined || basis === undefined) return null;\n\n  return {\n    declarations: [\n      { property: 'flex-grow', value: grow },\n      { property: 'flex-shrink', value: shrink },\n      { property: 'flex-basis', value: basis },\n    ],\n    confident: true,\n  };\n}\n\n/**\n * A single number is `flex-grow`; a single length is `flex-basis`. The\n * one-value form is the only place the two are distinguishable at all, which is\n * why the split happens here rather than positionally.\n */\nfunction classifyFlexParts(\n  parts: readonly string[],\n): readonly [string, string, string] | null {\n  if (parts.length === 1) {\n    const only = parts[0]!;\n    if (isBareNumber(only)) return [only, '1', '0%'];\n    if (isLength(only) || only === 'auto' || only === 'content') return ['1', '1', only];\n    return null;\n  }\n\n  if (parts.length === 2) {\n    const [first, second] = parts as [string, string];\n    if (!isBareNumber(first)) return null;\n    if (isBareNumber(second)) return [first, second, '0%'];\n    return [first, '1', second];\n  }\n\n  if (parts.length === 3) {\n    const [grow, shrink, basis] = parts as [string, string, string];\n    if (!isBareNumber(grow) || !isBareNumber(shrink)) return null;\n    return [grow, shrink, basis];\n  }\n\n  return null;\n}\n\nfunction expandFlexFlow(value: string): Expansion | null {\n  const parts = topLevelParts(value);\n  if (parts.length === 0 || parts.length > 2) return null;\n\n  const wraps = new Set(['nowrap', 'wrap', 'wrap-reverse']);\n  const directions = new Set(['row', 'row-reverse', 'column', 'column-reverse']);\n\n  let direction: string | undefined;\n  let wrap: string | undefined;\n\n  for (const part of parts) {\n    const lower = part.toLowerCase();\n    if (directions.has(lower)) {\n      if (direction !== undefined) return null;\n      direction = lower;\n    } else if (wraps.has(lower)) {\n      if (wrap !== undefined) return null;\n      wrap = lower;\n    } else {\n      return null;\n    }\n  }\n\n  return {\n    declarations: [\n      { property: 'flex-direction', value: direction ?? 'row' },\n      { property: 'flex-wrap', value: wrap ?? 'nowrap' },\n    ],\n    confident: true,\n  };\n}\n\nfunction expandTextDecoration(value: string): Expansion | null {\n  const parts = topLevelParts(value);\n  if (parts.length === 0 || parts.length > 4) return null;\n\n  const lines = new Set(['none', 'underline', 'overline', 'line-through', 'blink']);\n  const styles = new Set(['solid', 'double', 'dotted', 'dashed', 'wavy']);\n\n  const lineParts: string[] = [];\n  let style: string | undefined;\n  let color: string | undefined;\n  let thickness: string | undefined;\n\n  for (const part of parts) {\n    const lower = part.toLowerCase();\n    if (lines.has(lower)) lineParts.push(lower);\n    else if (styles.has(lower)) {\n      if (style !== undefined) return null;\n      style = lower;\n    } else if (lower === 'auto' || lower === 'from-font' || isLength(part)) {\n      if (thickness !== undefined) return null;\n      thickness = part;\n    } else if (lower === 'currentcolor' || parseColor(part) !== null || part.startsWith('var(')) {\n      if (color !== undefined) return null;\n      color = part;\n    } else {\n      return null;\n    }\n  }\n\n  return {\n    declarations: [\n      { property: 'text-decoration-line', value: lineParts.length > 0 ? lineParts.join(' ') : 'none' },\n      { property: 'text-decoration-style', value: style ?? 'solid' },\n      { property: 'text-decoration-color', value: color ?? 'currentcolor' },\n      { property: 'text-decoration-thickness', value: thickness ?? 'auto' },\n    ],\n    confident: true,\n  };\n}\n\n/**\n * Split on whitespace, but never inside a function call.\n *\n * `margin: calc(1px + 2px) 0` is two values, not four. Splitting naively would\n * silently corrupt every `calc()`, `var()`, and gradient in the corpus.\n */\nexport function topLevelParts(value: string): string[] {\n  const parts: string[] = [];\n  let depth = 0;\n  let current = '';\n\n  for (const char of value.trim()) {\n    if (char === '(') depth += 1;\n    else if (char === ')') depth -= 1;\n\n    if (depth === 0 && /\\s/.test(char)) {\n      if (current.length > 0) parts.push(current);\n      current = '';\n      continue;\n    }\n    current += char;\n  }\n\n  if (current.length > 0) parts.push(current);\n  return parts;\n}\n\n/**\n * `inherit`, `initial`, `unset`, `revert`, and any `var()` reference are\n * indivisible: they apply to the whole shorthand and cannot be distributed to\n * longhands without resolving them first.\n */\nfunction isGlobalKeywordAmbiguity(part: string): boolean {\n  const lower = part.toLowerCase();\n  return (\n    lower === 'inherit' ||\n    lower === 'initial' ||\n    lower === 'unset' ||\n    lower === 'revert' ||\n    lower === 'revert-layer'\n  );\n}\n\nfunction isLength(part: string): boolean {\n  return /^[+-]?(\\d+\\.?\\d*|\\.\\d+)([a-z]+|%)?$/i.test(part) || part.toLowerCase().startsWith('calc(');\n}\n\nfunction isBareNumber(part: string): boolean {\n  return /^[+-]?(\\d+\\.?\\d*|\\.\\d+)$/.test(part);\n}\n"]}

package/dist/rules/normalize/value.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Units left symbolic because they cannot be resolved without a layout engine.
+ *
+ * This is the `declared-only` boundary made concrete (ADR-0002): under a profile
+ * without computed style, `padding: 1rem` stays `1rem`. That is honest — it is
+ * genuinely all that tier knows — and it is why JSDOM decides the token band
+ * `declared-only` rather than `full`. Resolving these by assuming a root font
+ * size would fabricate precision the tier does not have.
+ */
+export declare const RELATIVE_UNITS: readonly string[];
+export declare function canonicalizeValue(property: string, value: string): string;
+/**
+ * Rewrite a value token by token.
+ *
+ * Quoted strings and `url()` payloads are passed through untouched: a font
+ * family name and a resource path are opaque data, and normalizing their case
+ * would change what they refer to.
+ */
+export declare function canonicalizeTokens(value: string): string;
+/** Canonicalize one `<number><unit>` token. */
+export declare function canonicalizeDimension(token: string): string;
+export declare function isRelativeUnit(unit: string): boolean;
+//# sourceMappingURL=value.d.ts.map