@zslabs/atomic-css-modules 0.1.0

package/dist/scan.js

@@ -0,0 +1,177 @@
+import { transform } from 'lightningcss';
+import { atomClassNameForKey, atomKeyString, buildAtomKey } from './atom-key.js';
+import { declarationProperty, flattenDeclarations, isComposesDeclaration, } from './declaration-utils.js';
+import { allocateUniqueClassName } from './hash.js';
+import { RuleContextTracker } from './rule-context.js';
+import { classifyEligibleGroup, classifySelector, printSelectorList, skipReasonForSelector, skipReasonForSelectors, } from './selector-utils.js';
+import { findShorthandConflicts } from './shorthand-groups.js';
+import { hasAtomicSkipComment } from './skip-comment.js';
+function ineligibleRuleInfo(context) {
+    return {
+        eligible: false,
+        condition: context.condition,
+        nested: context.nested,
+        pseudo: null,
+        selector: [],
+        atomKeys: [],
+        atomHashes: [],
+        decisions: [],
+    };
+}
+function collectAtoms(block, context, classification, atoms, taken, debugNames) {
+    const flatDeclarations = flattenDeclarations(block);
+    const shorthandConflicts = findShorthandConflicts(flatDeclarations
+        .filter(({ declaration }) => !isComposesDeclaration(declaration))
+        .map(({ declaration }) => declarationProperty(declaration)));
+    const atomKeys = [];
+    const atomHashes = [];
+    const decisions = [];
+    for (const { declaration, important } of flatDeclarations) {
+        if (isComposesDeclaration(declaration)) {
+            decisions.push({ action: 'composes' });
+            continue;
+        }
+        const property = declarationProperty(declaration);
+        if (shorthandConflicts.has(property)) {
+            decisions.push({ action: 'keep', important });
+            continue;
+        }
+        const key = buildAtomKey({
+            property,
+            declaration,
+            important,
+            pseudo: classification.pseudo,
+            condition: context.condition,
+        });
+        const keyString = atomKeyString(key);
+        let atom = atoms.get(keyString);
+        if (!atom) {
+            const desired = atomClassNameForKey(key, declaration, debugNames);
+            const hash = allocateUniqueClassName(taken, desired);
+            taken.add(hash);
+            atom = { hash, className: hash, key, keyString, declaration };
+            atoms.set(keyString, atom);
+        }
+        atomKeys.push(keyString);
+        atomHashes.push(atom.hash);
+        decisions.push({ action: 'hoist', atomKey: keyString });
+    }
+    return {
+        atomKeys,
+        atomHashes,
+        decisions,
+        shorthandConflict: shorthandConflicts.size > 0,
+    };
+}
+function recordShorthandSkip(skips, filePath, selector, shorthandConflict) {
+    if (!shorthandConflict)
+        return;
+    skips.push({
+        filePath,
+        selector: printSelectorList([selector]),
+        reason: 'shorthand-conflict',
+    });
+}
+function scanStyleLikeRule(rule, context, atoms, taken, rules, skips, file, debugNames) {
+    const loc = rule.type === 'style' || rule.type === 'nested-declarations'
+        ? rule.value.loc
+        : null;
+    if (loc && hasAtomicSkipComment(file.code, loc)) {
+        const selectors = rule.type === 'style'
+            ? rule.value.selectors.flatMap((selector) => context.resolveAll(selector))
+            : context.selectors;
+        rules.push(ineligibleRuleInfo(context));
+        skips.push({
+            filePath: file.filePath,
+            selector: printSelectorList(selectors),
+            reason: 'skip-comment',
+        });
+        return;
+    }
+    if (rule.type === 'nested-declarations') {
+        let anyEligible = false;
+        for (const parentSelector of context.selectors) {
+            const classification = classifySelector(parentSelector);
+            if (!classification.eligible) {
+                skips.push({
+                    filePath: file.filePath,
+                    selector: printSelectorList([parentSelector]),
+                    reason: skipReasonForSelector(parentSelector),
+                });
+                continue;
+            }
+            anyEligible = true;
+            const collected = collectAtoms(rule.value.declarations, context, classification, atoms, taken, debugNames);
+            rules.push({
+                eligible: true,
+                condition: context.condition,
+                nested: context.nested,
+                pseudo: classification.pseudo,
+                selector: classification.strippedSelector,
+                atomKeys: collected.atomKeys,
+                atomHashes: collected.atomHashes,
+                decisions: collected.decisions,
+            });
+            recordShorthandSkip(skips, file.filePath, classification.strippedSelector, collected.shorthandConflict);
+        }
+        if (!anyEligible)
+            rules.push(ineligibleRuleInfo(context));
+        return;
+    }
+    if (rule.type !== 'style')
+        return;
+    const resolved = rule.value.selectors.flatMap((selector) => context.resolveAll(selector));
+    const classifications = classifyEligibleGroup(resolved);
+    if (!classifications) {
+        rules.push(ineligibleRuleInfo(context));
+        skips.push({
+            filePath: file.filePath,
+            selector: printSelectorList(resolved),
+            reason: skipReasonForSelectors(resolved),
+        });
+        return;
+    }
+    for (const classification of classifications) {
+        const collected = collectAtoms(rule.value.declarations, context, classification, atoms, taken, debugNames);
+        rules.push({
+            eligible: true,
+            condition: context.condition,
+            nested: context.nested,
+            pseudo: classification.pseudo,
+            selector: classification.strippedSelector,
+            atomKeys: collected.atomKeys,
+            atomHashes: collected.atomHashes,
+            decisions: collected.decisions,
+        });
+        recordShorthandSkip(skips, file.filePath, classification.strippedSelector, collected.shorthandConflict);
+    }
+}
+function scanFile(file, atoms, taken, skips, debugNames) {
+    const tracker = new RuleContextTracker();
+    const rules = [];
+    transform({
+        filename: file.filePath,
+        code: Buffer.from(file.code, 'utf8'),
+        visitor: {
+            Rule(rule) {
+                const context = tracker.enter(rule);
+                if (!context)
+                    return;
+                scanStyleLikeRule(rule, context, atoms, taken, rules, skips, file, debugNames);
+            },
+            RuleExit(rule) {
+                tracker.exit(rule);
+            },
+        },
+    });
+    return { filePath: file.filePath, rules };
+}
+export function scanFiles(files, options = {}) {
+    const atoms = new Map();
+    const taken = new Set();
+    const skips = [];
+    const debugNames = options.debugNames === true;
+    const scannedFiles = files.map((file) => scanFile(file, atoms, taken, skips, debugNames));
+    return { atoms, files: scannedFiles, skips };
+}
+//# sourceMappingURL=scan.js.map

package/dist/scan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan.js","sourceRoot":"","sources":["../src/scan.ts"],"names":[],"mappings":"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"}

package/dist/selector-utils.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Rules for deciding whether a StyleRule's selector is eligible for
+ * atomization, per GUIDE.md "What selectors are supported".
+ */
+import type { Selector, SelectorList } from 'lightningcss';
+import type { AtomPseudo, SkipReason } from './types.js';
+export interface SelectorClassification {
+    eligible: boolean;
+    /** The simple trailing pseudo carried by this selector, if any. */
+    pseudo: AtomPseudo | null;
+    /** The selector with any trailing simple pseudo removed. */
+    strippedSelector: Selector;
+}
+/**
+ * Classifies a single (non-grouped) selector. CSS Modules only allows
+ * `composes` on a single local class, so combinators, extra classes,
+ * elements, and attributes are rejected. A trailing simple pseudo
+ * (`.button:hover`) is still eligible; the pseudo is hoisted onto the atom.
+ */
+export declare function classifySelector(selector: Selector): SelectorClassification;
+/**
+ * Resolves a nested selector against its parent. `&` is replaced with the
+ * parent selector; a nested selector with no `&` is treated as a descendant.
+ */
+export declare function resolveNesting(parent: Selector, nested: Selector): Selector;
+/** Comma-separated selector groups (`.a, .b { ... }`) can be split when every selector is eligible. */
+export declare function isGroupedSelectorList(selectorList: SelectorList): boolean;
+/** Classifies every selector in a list. Returns null if any selector is ineligible. */
+export declare function classifyEligibleGroup(selectors: SelectorList): SelectorClassification[] | null;
+export declare function skipReasonForSelector(selector: Selector): SkipReason;
+export declare function skipReasonForSelectors(selectors: SelectorList): SkipReason;
+export declare function printSelectorList(selectors: SelectorList): string;
+export declare function selectorKey(selector: Selector): string;
+export declare function selectorsEqual(a: Selector, b: Selector): boolean;

package/dist/selector-utils.js

@@ -0,0 +1,156 @@
+import { transform } from 'lightningcss';
+/**
+ * Fields on a pseudo-class/element component that indicate it takes an
+ * argument (a nested selector, an nth-child formula, a language tag, etc).
+ * Anything with one of these is a "functional" pseudo and can't be safely
+ * hoisted onto a shared atomic class - see GUIDE.md "What selectors are supported".
+ * Rather than hand-listing which pseudo kinds are "simple", this is derived
+ * structurally from whatever lightningcss actually parsed: a pseudo with none
+ * of these argument fields is simple, regardless of its kind name.
+ */
+/**
+ * Fields that are always present on a parsed pseudo (or harmless extras
+ * like a vendor prefix / custom name) and do not mean the pseudo takes
+ * arguments. Anything else — `selectors`, `a`/`b`, `arguments`, etc. —
+ * makes it functional and ineligible to hoist.
+ *
+ * Do not treat `type` as an argument field: every LightningCSS selector
+ * component has `type: "pseudo-class" | "pseudo-element"`.
+ */
+const SIMPLE_PSEUDO_KEYS = new Set(['type', 'kind', 'vendorPrefix', 'name']);
+function isPseudoComponent(component) {
+    return (component.type === 'pseudo-class' || component.type === 'pseudo-element');
+}
+/** True for a pseudo-class/element with no functional arguments, e.g. `:hover` or `::before`, but not `:not(...)` or `:nth-child(...)`. */
+function isSimplePseudo(component) {
+    return Object.keys(component).every((key) => SIMPLE_PSEUDO_KEYS.has(key));
+}
+const NOT_ELIGIBLE = {
+    eligible: false,
+    pseudo: null,
+    strippedSelector: [],
+};
+/**
+ * Classifies a single (non-grouped) selector. CSS Modules only allows
+ * `composes` on a single local class, so combinators, extra classes,
+ * elements, and attributes are rejected. A trailing simple pseudo
+ * (`.button:hover`) is still eligible; the pseudo is hoisted onto the atom.
+ */
+export function classifySelector(selector) {
+    if (selector.length === 0)
+        return NOT_ELIGIBLE;
+    let classCount = 0;
+    let trailingPseudo = null;
+    for (let index = 0; index < selector.length; index++) {
+        const component = selector[index];
+        if (!component)
+            return NOT_ELIGIBLE;
+        if (component.type === 'class') {
+            classCount += 1;
+            continue;
+        }
+        const isTrailing = index === selector.length - 1;
+        if (isTrailing &&
+            isPseudoComponent(component) &&
+            isSimplePseudo(component)) {
+            trailingPseudo = component;
+            continue;
+        }
+        return NOT_ELIGIBLE;
+    }
+    if (classCount !== 1)
+        return NOT_ELIGIBLE;
+    return {
+        eligible: true,
+        pseudo: trailingPseudo,
+        strippedSelector: trailingPseudo ? selector.slice(0, -1) : selector,
+    };
+}
+/**
+ * Resolves a nested selector against its parent. `&` is replaced with the
+ * parent selector; a nested selector with no `&` is treated as a descendant.
+ */
+export function resolveNesting(parent, nested) {
+    if (nested.some((component) => component.type === 'nesting')) {
+        return nested.flatMap((component) => component.type === 'nesting' ? parent : [component]);
+    }
+    return [...parent, { type: 'combinator', value: 'descendant' }, ...nested];
+}
+/** Comma-separated selector groups (`.a, .b { ... }`) can be split when every selector is eligible. */
+export function isGroupedSelectorList(selectorList) {
+    return selectorList.length > 1;
+}
+/** Classifies every selector in a list. Returns null if any selector is ineligible. */
+export function classifyEligibleGroup(selectors) {
+    const items = selectors.map((selector) => classifySelector(selector));
+    if (items.length === 0 || items.some((item) => !item.eligible))
+        return null;
+    return items;
+}
+export function skipReasonForSelector(selector) {
+    let classCount = 0;
+    let simplePseudoCount = 0;
+    let hasCombinator = false;
+    let hasFunctionalPseudo = false;
+    for (const component of selector) {
+        if (component.type === 'combinator') {
+            hasCombinator = true;
+            continue;
+        }
+        if (component.type === 'class') {
+            classCount += 1;
+            continue;
+        }
+        if (component.type === 'nesting')
+            continue;
+        if (isPseudoComponent(component)) {
+            if (isSimplePseudo(component))
+                simplePseudoCount += 1;
+            else
+                hasFunctionalPseudo = true;
+        }
+    }
+    if (hasCombinator)
+        return 'combinator';
+    if (hasFunctionalPseudo)
+        return 'functional-pseudo';
+    if (simplePseudoCount > 1)
+        return 'chained-pseudo';
+    if (classCount > 1)
+        return 'compound';
+    return 'element';
+}
+export function skipReasonForSelectors(selectors) {
+    if (selectors.length > 1)
+        return 'mixed-group';
+    return skipReasonForSelector(selectors[0] ?? []);
+}
+export function printSelectorList(selectors) {
+    if (selectors.length === 0)
+        return '';
+    const result = transform({
+        filename: 'selector.css',
+        code: Buffer.from('._{color:red}'),
+        visitor: {
+            StyleSheetExit(sheet) {
+                const rule = sheet.rules[0];
+                if (rule?.type === 'style')
+                    rule.value.selectors = selectors;
+                return sheet;
+            },
+        },
+    });
+    const css = Buffer.from(result.code).toString('utf8');
+    const match = /^([^{]+)\{/.exec(css);
+    return (match?.[1] ?? '')
+        .trim()
+        .replace(/\s*,\s*/g, ', ')
+        .replace(/\s+/g, ' ');
+}
+export function selectorKey(selector) {
+    return JSON.stringify(selector);
+}
+export function selectorsEqual(a, b) {
+    return selectorKey(a) === selectorKey(b);
+}
+//# sourceMappingURL=selector-utils.js.map

package/dist/selector-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selector-utils.js","sourceRoot":"","sources":["../src/selector-utils.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAGxC;;;;;;;;GAQG;AACH;;;;;;;;GAQG;AACH,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,CAAC,CAAC,CAAA;AAE5E,SAAS,iBAAiB,CACxB,SAA4B;IAK5B,OAAO,CACL,SAAS,CAAC,IAAI,KAAK,cAAc,IAAI,SAAS,CAAC,IAAI,KAAK,gBAAgB,CACzE,CAAA;AACH,CAAC;AAED,2IAA2I;AAC3I,SAAS,cAAc,CACrB,SAGC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,kBAAkB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAA;AAC3E,CAAC;AAUD,MAAM,YAAY,GAA2B;IAC3C,QAAQ,EAAE,KAAK;IACf,MAAM,EAAE,IAAI;IACZ,gBAAgB,EAAE,EAAE;CACrB,CAAA;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAkB;IACjD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,YAAY,CAAA;IAE9C,IAAI,UAAU,GAAG,CAAC,CAAA;IAClB,IAAI,cAAc,GAAsB,IAAI,CAAA;IAE5C,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;QACrD,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAA;QACjC,IAAI,CAAC,SAAS;YAAE,OAAO,YAAY,CAAA;QAEnC,IAAI,SAAS,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC/B,UAAU,IAAI,CAAC,CAAA;YACf,SAAQ;QACV,CAAC;QAED,MAAM,UAAU,GAAG,KAAK,KAAK,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAA;QAChD,IACE,UAAU;YACV,iBAAiB,CAAC,SAAS,CAAC;YAC5B,cAAc,CAAC,SAAS,CAAC,EACzB,CAAC;YACD,cAAc,GAAG,SAAS,CAAA;YAC1B,SAAQ;QACV,CAAC;QAED,OAAO,YAAY,CAAA;IACrB,CAAC;IAED,IAAI,UAAU,KAAK,CAAC;QAAE,OAAO,YAAY,CAAA;IAEzC,OAAO;QACL,QAAQ,EAAE,IAAI;QACd,MAAM,EAAE,cAAc;QACtB,gBAAgB,EAAE,cAAc,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ;KACpE,CAAA;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,MAAgB,EAAE,MAAgB;IAC/D,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,KAAK,SAAS,CAAC,EAAE,CAAC;QAC7D,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,EAAE,EAAE,CAClC,SAAS,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CACpD,CAAA;IACH,CAAC;IACD,OAAO,CAAC,GAAG,MAAM,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,GAAG,MAAM,CAAC,CAAA;AAC5E,CAAC;AAED,uGAAuG;AACvG,MAAM,UAAU,qBAAqB,CAAC,YAA0B;IAC9D,OAAO,YAAY,CAAC,MAAM,GAAG,CAAC,CAAA;AAChC,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,qBAAqB,CACnC,SAAuB;IAEvB,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAA;IACrE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAA;IAC3E,OAAO,KAAK,CAAA;AACd,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,QAAkB;IACtD,IAAI,UAAU,GAAG,CAAC,CAAA;IAClB,IAAI,iBAAiB,GAAG,CAAC,CAAA;IACzB,IAAI,aAAa,GAAG,KAAK,CAAA;IACzB,IAAI,mBAAmB,GAAG,KAAK,CAAA;IAE/B,KAAK,MAAM,SAAS,IAAI,QAAQ,EAAE,CAAC;QACjC,IAAI,SAAS,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YACpC,aAAa,GAAG,IAAI,CAAA;YACpB,SAAQ;QACV,CAAC;QACD,IAAI,SAAS,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC/B,UAAU,IAAI,CAAC,CAAA;YACf,SAAQ;QACV,CAAC;QACD,IAAI,SAAS,CAAC,IAAI,KAAK,SAAS;YAAE,SAAQ;QAC1C,IAAI,iBAAiB,CAAC,SAAS,CAAC,EAAE,CAAC;YACjC,IAAI,cAAc,CAAC,SAAS,CAAC;gBAAE,iBAAiB,IAAI,CAAC,CAAA;;gBAChD,mBAAmB,GAAG,IAAI,CAAA;QACjC,CAAC;IACH,CAAC;IAED,IAAI,aAAa;QAAE,OAAO,YAAY,CAAA;IACtC,IAAI,mBAAmB;QAAE,OAAO,mBAAmB,CAAA;IACnD,IAAI,iBAAiB,GAAG,CAAC;QAAE,OAAO,gBAAgB,CAAA;IAClD,IAAI,UAAU,GAAG,CAAC;QAAE,OAAO,UAAU,CAAA;IACrC,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,SAAuB;IAC5D,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,aAAa,CAAA;IAC9C,OAAO,qBAAqB,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAA;AAClD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,SAAuB;IACvD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAA;IACrC,MAAM,MAAM,GAAG,SAAS,CAAC;QACvB,QAAQ,EAAE,cAAc;QACxB,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC;QAClC,OAAO,EAAE;YACP,cAAc,CAAC,KAAK;gBAClB,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;gBAC3B,IAAI,IAAI,EAAE,IAAI,KAAK,OAAO;oBAAE,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,SAAS,CAAA;gBAC5D,OAAO,KAAK,CAAA;YACd,CAAC;SACF;KACF,CAAC,CAAA;IACF,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;IACrD,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACpC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACtB,IAAI,EAAE;SACN,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC;SACzB,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;AACzB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,QAAkB;IAC5C,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAA;AACjC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,CAAW,EAAE,CAAW;IACrD,OAAO,WAAW,CAAC,CAAC,CAAC,KAAK,WAAW,CAAC,CAAC,CAAC,CAAA;AAC1C,CAAC"}

package/dist/shorthand-groups.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Properties in one rule that are unsafe to atomize because they write the
+ * same longhand: a shorthand plus one of its longhands, or two shorthands
+ * that overlap (e.g. `border-width` + `border-top`). Sibling longhands
+ * (`font-size` + `font-family`) do not overlap and are safe.
+ */
+export declare function findShorthandConflicts(properties: readonly string[]): Set<string>;

package/dist/shorthand-groups.js

@@ -0,0 +1,85 @@
+/**
+ * Shorthand/longhand property groupings, derived from MDN's `mdn-data`
+ * dataset (the same data browsers and MDN docs are generated from) rather
+ * than a hand-maintained list. If a rule declares a shorthand alongside one
+ * of its own longhands, neither is safe to atomize (see GUIDE.md "Shorthand
+ * and longhand").
+ */
+import { createRequire } from 'node:module';
+const require = createRequire(import.meta.url);
+const cssProperties = require('mdn-data/css/properties.json');
+function listedLonghands(info) {
+    const names = new Set();
+    for (const field of [info.initial, info.computed]) {
+        if (!Array.isArray(field))
+            continue;
+        for (const longhand of field)
+            names.add(longhand);
+    }
+    return [...names];
+}
+/** Direct + nested longhands for every MDN shorthand. */
+const shorthandLonghands = new Map();
+function collectLonghands(property, seen) {
+    const cached = shorthandLonghands.get(property);
+    if (cached && seen.size === 0)
+        return cached;
+    const info = cssProperties[property];
+    if (!info)
+        return new Set();
+    const children = listedLonghands(info);
+    if (children.length === 0)
+        return new Set();
+    const longhands = new Set();
+    for (const child of children) {
+        if (seen.has(child))
+            continue;
+        seen.add(child);
+        longhands.add(child);
+        for (const nested of collectLonghands(child, seen))
+            longhands.add(nested);
+    }
+    return longhands;
+}
+for (const property of Object.keys(cssProperties)) {
+    const longhands = collectLonghands(property, new Set());
+    if (longhands.size > 0)
+        shorthandLonghands.set(property, longhands);
+}
+/** Longhands a property sets: itself if it is a longhand, else its expansion. */
+function coverage(property) {
+    return shorthandLonghands.get(property) ?? new Set([property]);
+}
+function setsOverlap(left, right) {
+    for (const value of left) {
+        if (right.has(value))
+            return true;
+    }
+    return false;
+}
+/**
+ * Properties in one rule that are unsafe to atomize because they write the
+ * same longhand: a shorthand plus one of its longhands, or two shorthands
+ * that overlap (e.g. `border-width` + `border-top`). Sibling longhands
+ * (`font-size` + `font-family`) do not overlap and are safe.
+ */
+export function findShorthandConflicts(properties) {
+    const conflicts = new Set();
+    for (let i = 0; i < properties.length; i++) {
+        const left = properties[i];
+        if (left === undefined)
+            continue;
+        const leftCoverage = coverage(left);
+        for (let j = i + 1; j < properties.length; j++) {
+            const right = properties[j];
+            if (right === undefined)
+                continue;
+            if (!setsOverlap(leftCoverage, coverage(right)))
+                continue;
+            conflicts.add(left);
+            conflicts.add(right);
+        }
+    }
+    return conflicts;
+}
+//# sourceMappingURL=shorthand-groups.js.map

package/dist/shorthand-groups.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shorthand-groups.js","sourceRoot":"","sources":["../src/shorthand-groups.ts"],"names":[],"mappings":"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"}

package/dist/skip-comment.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Detect an `atomic: skip` CSS comment from source text. LightningCSS drops
+ * comments from the AST, so we look next to the rule's source location.
+ */
+import type { Location2 } from 'lightningcss';
+export declare function hasAtomicSkipComment(code: string, loc: Location2): boolean;

package/dist/skip-comment.js

@@ -0,0 +1,48 @@
+const SKIP_BODY = /^atomic:\s*skip$/i;
+function locOffset(code, loc) {
+    let line = 0;
+    let index = 0;
+    while (line < loc.line && index < code.length) {
+        if (code[index] === '\n')
+            line += 1;
+        index += 1;
+    }
+    return Math.min(code.length, index + Math.max(loc.column, 1) - 1);
+}
+function isSkipBody(body) {
+    return SKIP_BODY.test(body.trim());
+}
+function commentBefore(code, offset) {
+    let index = offset - 1;
+    while (index >= 0 && /\s/.test(code[index] ?? ''))
+        index -= 1;
+    if (index < 1 || code[index] !== '/' || code[index - 1] !== '*')
+        return null;
+    const start = code.lastIndexOf('/*', index - 1);
+    if (start === -1)
+        return null;
+    return code.slice(start + 2, index - 1);
+}
+function firstBlockComment(code, offset) {
+    const open = code.indexOf('{', offset);
+    if (open === -1)
+        return null;
+    let index = open + 1;
+    while (index < code.length && /\s/.test(code[index] ?? ''))
+        index += 1;
+    if (code.slice(index, index + 2) !== '/*')
+        return null;
+    const close = code.indexOf('*/', index + 2);
+    if (close === -1)
+        return null;
+    return code.slice(index + 2, close);
+}
+export function hasAtomicSkipComment(code, loc) {
+    const offset = locOffset(code, loc);
+    const before = commentBefore(code, offset);
+    if (before !== null && isSkipBody(before))
+        return true;
+    const inside = firstBlockComment(code, offset);
+    return inside !== null && isSkipBody(inside);
+}
+//# sourceMappingURL=skip-comment.js.map

package/dist/skip-comment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skip-comment.js","sourceRoot":"","sources":["../src/skip-comment.ts"],"names":[],"mappings":"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"}