@12ui/design 0.2.53 → 0.2.55

package/dist/improve-dom-anchor.js

@@ -0,0 +1,120 @@
+import { boxIou } from './improve-layerdoc-diff.js';
+import { toCanvasFrame } from './improve-dom-scale.js';
+export const selectorLabel = (leaf) => {
+    const dom = leaf?.dom;
+    if (!dom)
+        return '(unanchored)';
+    if (dom.selectorKind === 'path' && dom.classSelector) {
+        return `\`${dom.classSelector}\`[${dom.classSelectorIndex}/${dom.classSelectorMatches}] (${dom.path})`;
+    }
+    if (dom.selectorKind === 'path')
+        return `\`${dom.path}\``;
+    return `\`${dom.selector}\` (${dom.path ?? dom.selector})`;
+};
+const area = (box) => box ? box[2] * box[3] : 0;
+export const containment = (inner, outer) => {
+    if (!inner || !outer)
+        return 0;
+    const width = Math.max(0, Math.min(inner[0] + inner[2], outer[0] + outer[2]) - Math.max(inner[0], outer[0]));
+    const height = Math.max(0, Math.min(inner[1] + inner[3], outer[1] + outer[3]) - Math.max(inner[1], outer[1]));
+    return area(inner) > 0 ? width * height / area(inner) : 0;
+};
+export const confidentMatches = (matched, before, after, minimumIou = 0.3) => {
+    const result = new Set();
+    const normalized = (value) => typeof value === 'string'
+        ? value.replace(/\s+/gu, ' ').trim().toLowerCase()
+        : '';
+    for (const entry of matched) {
+        const left = before[entry.beforeIndex];
+        const right = after[entry.afterIndex];
+        if (!left || !right)
+            continue;
+        const leftContent = normalized(left.content);
+        if (leftContent && leftContent === normalized(right.content))
+            result.add(entry.beforeIndex);
+        else if (left.box && right.box && boxIou(left.box, right.box) >= minimumIou)
+            result.add(entry.beforeIndex);
+    }
+    return result;
+};
+export const insertionAnchor = (box, before) => {
+    let container = -1;
+    let containerArea = Number.POSITIVE_INFINITY;
+    before.forEach((leaf, index) => {
+        if (leaf.kind === 'background' || containment(box, leaf.box) < 0.75)
+            return;
+        const candidateArea = area(leaf.box);
+        if (candidateArea > 0 && candidateArea < containerArea) {
+            container = index;
+            containerArea = candidateArea;
+        }
+    });
+    if (container < 0)
+        return { container };
+    const siblings = before.map((_leaf, index) => index)
+        .filter((index) => before[index]?.dom?.parentIndex === container);
+    const above = siblings.filter((index) => {
+        const sibling = before[index]?.box;
+        return sibling && sibling[1] + sibling[3] <= box[1] + 0.002;
+    }).sort((left, right) => {
+        const leftBox = before[left].box;
+        const rightBox = before[right].box;
+        return (rightBox[1] + rightBox[3]) - (leftBox[1] + leftBox[3]);
+    })[0];
+    const below = siblings.filter((index) => (before[index]?.box?.[1] ?? -1) >= box[1] + box[3] - 0.002)
+        .sort((left, right) => before[left].box[1] - before[right].box[1])[0];
+    return {
+        container,
+        ...(above === undefined ? {} : { after: above }),
+        ...(below === undefined ? {} : { before: below }),
+    };
+};
+export const impliedPaddingDeltas = (matched, before, after, canvas, confident) => {
+    const partner = new Map(matched
+        .filter((entry) => confident.has(entry.beforeIndex))
+        .map((entry) => [entry.beforeIndex, entry.afterIndex]));
+    const children = new Map();
+    before.forEach((leaf, index) => {
+        const parent = leaf.dom?.parentIndex;
+        if (parent === undefined || parent < 0)
+            return;
+        children.set(parent, [...(children.get(parent) ?? []), index]);
+    });
+    const output = new Map();
+    for (const [containerIndex, childIndices] of children) {
+        const afterContainerIndex = partner.get(containerIndex);
+        const leftBox = before[containerIndex]?.box;
+        const rightBox = afterContainerIndex === undefined ? undefined : after[afterContainerIndex]?.box;
+        if (!leftBox || !rightBox)
+            continue;
+        const pairs = childIndices.flatMap((childIndex) => {
+            const afterIndex = partner.get(childIndex);
+            const left = before[childIndex]?.box;
+            const right = afterIndex === undefined ? undefined : after[afterIndex]?.box;
+            return left && right && containment(right, rightBox) >= 0.7 ? [[left, right]] : [];
+        });
+        if (pairs.length < 2)
+            continue;
+        const specs = [
+            { field: 'style.paddingLeft', scale: canvas.width, inset: (box, parent) => box[0] - parent[0] },
+            { field: 'style.paddingTop', scale: canvas.height, inset: (box, parent) => box[1] - parent[1] },
+        ];
+        const deltas = specs.flatMap((spec) => {
+            const prior = Math.min(...pairs.map(([box]) => spec.inset(box, leftBox))) * spec.scale;
+            const target = Math.min(...pairs.map(([, box]) => spec.inset(box, rightBox))) * spec.scale;
+            const drift = target - prior;
+            return Math.abs(drift) >= 3 && target >= 0 ? [{
+                    field: spec.field,
+                    before: Math.round(prior * 10) / 10,
+                    after: Math.round(target * 10) / 10,
+                    driftPx: Math.round(drift * 10) / 10,
+                    basis: `implied from ${pairs.length} matched children`,
+                }] : [];
+        });
+        if (deltas.length > 0)
+            output.set(containerIndex, deltas);
+    }
+    return output;
+};
+export const domPx = toCanvasFrame;
+//# sourceMappingURL=improve-dom-anchor.js.map

package/dist/improve-dom-anchor.js.map

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

package/dist/improve-dom-diff.d.ts

@@ -0,0 +1,33 @@
+import type { ImproveGate, LayerDiffResult, LayerLeaf } from './improve-layerdoc-types.js';
+export type ImproveDomDiff = {
+    result: LayerDiffResult;
+    beforeLeaves: LayerLeaf[];
+    targetLeaves: LayerLeaf[];
+    beforeCanvas: {
+        width: number;
+        height: number;
+    };
+    targetCanvas: {
+        width: number;
+        height: number;
+    };
+    lengthScale: number;
+    domCoverage: number;
+    designCoverage: number;
+    gate: ImproveGate;
+    markdown: string;
+};
+export declare const computeImproveDomDiff: (args: {
+    beforeDoc: unknown;
+    targetDoc: unknown;
+    gatePct?: number;
+}) => ImproveDomDiff;
+export declare const writeImproveDomDiff: (args: {
+    beforePath: string;
+    targetPath: string;
+    outDir: string;
+    gatePct?: number;
+}) => Promise<ImproveDomDiff & {
+    artifacts: string[];
+}>;
+//# sourceMappingURL=improve-dom-diff.d.ts.map

package/dist/improve-dom-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"improve-dom-diff.d.ts","sourceRoot":"","sources":["../src/improve-dom-diff.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAE3F,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,eAAe,CAAC;IACxB,YAAY,EAAE,SAAS,EAAE,CAAC;IAC1B,YAAY,EAAE,SAAS,EAAE,CAAC;IAC1B,YAAY,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAChD,YAAY,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAAI,MAAM;IAC1C,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,KAAG,cA2EH,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAAU,MAAM;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,KAAG,OAAO,CAAC,cAAc,GAAG;IAAE,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE,CA2CnD,CAAC"}

package/dist/improve-dom-diff.js

@@ -0,0 +1,129 @@
+import { mkdir, readFile, rm, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { canvasOfDoc, computeLayerDeltas, diffLayerDocs, flattenLayerDoc, } from './improve-layerdoc-diff.js';
+import { confidentMatches, impliedPaddingDeltas } from './improve-dom-anchor.js';
+import { evaluateImproveGate, renderImproveGate } from './improve-dom-gate.js';
+import { repairByNeighbourOffset } from './improve-dom-neighbour.js';
+import { normalizeLayerDoc } from './improve-dom-scale.js';
+import { renderDomChanges } from './improve-plan-render.js';
+export const computeImproveDomDiff = (args) => {
+    const beforeCanvas = canvasOfDoc(args.beforeDoc);
+    const targetCanvas = canvasOfDoc(args.targetDoc);
+    const viewport = args.beforeDoc && typeof args.beforeDoc === 'object' && 'source' in args.beforeDoc
+        && args.beforeDoc.source && typeof args.beforeDoc.source === 'object' && 'viewport' in args.beforeDoc.source
+        && args.beforeDoc.source.viewport && typeof args.beforeDoc.source.viewport === 'object'
+        ? args.beforeDoc.source.viewport
+        : undefined;
+    const anchoredHeight = typeof viewport?.height === 'number' && viewport.height !== beforeCanvas.height
+        ? viewport.height
+        : 0;
+    const lengthScale = beforeCanvas.width / targetCanvas.width;
+    const normalizedBefore = normalizeLayerDoc(args.beforeDoc, 1, anchoredHeight);
+    const normalizedTarget = normalizeLayerDoc(args.targetDoc, lengthScale);
+    const beforeLeaves = flattenLayerDoc(normalizedBefore);
+    const targetLeaves = flattenLayerDoc(normalizedTarget);
+    const result = diffLayerDocs(normalizedBefore, normalizedTarget, {
+        strategy: 'fallback',
+        contentKeyMode: 'family',
+    });
+    const firstConfidence = confidentMatches(result.matched, beforeLeaves, targetLeaves);
+    const neighbour = repairByNeighbourOffset({
+        result,
+        before: beforeLeaves,
+        after: targetLeaves,
+        confident: firstConfidence,
+        canvas: beforeCanvas,
+    });
+    for (const entry of result.matched.filter((candidate) => candidate.matchStrategy === 'neighbour')) {
+        entry.deltas = computeLayerDeltas(beforeLeaves[entry.beforeIndex], targetLeaves[entry.afterIndex]);
+        entry.changed = entry.deltas.length > 0;
+    }
+    const confident = confidentMatches(result.matched, beforeLeaves, targetLeaves);
+    result.matched.filter((entry) => entry.matchStrategy === 'neighbour')
+        .forEach((entry) => confident.add(entry.beforeIndex));
+    const padding = impliedPaddingDeltas(result.matched, beforeLeaves, targetLeaves, beforeCanvas, confident);
+    result.matched.forEach((entry) => {
+        entry.selector = beforeLeaves[entry.beforeIndex]?.dom?.selector;
+        entry.confident = confident.has(entry.beforeIndex);
+        entry.impliedPadding = padding.get(entry.beforeIndex);
+    });
+    result.meta = {
+        ...result.meta,
+        matchedCount: result.matched.length,
+        plausibleMatchedCount: confident.size,
+        changedCount: result.matched.filter((entry) => entry.changed).length,
+        unchangedCount: result.matched.filter((entry) => !entry.changed).length,
+        addedCount: result.added.length,
+        removedCount: result.removed.length,
+        matchCoverage: confident.size / Math.max(beforeLeaves.length, targetLeaves.length, 1),
+        neighbourRepaired: neighbour.repaired,
+        neighbourReleased: neighbour.released,
+    };
+    const domCoverage = confident.size / Math.max(beforeLeaves.length, 1);
+    const designCoverage = confident.size / Math.max(targetLeaves.length, 1);
+    const gate = evaluateImproveGate(domCoverage, args.gatePct);
+    return {
+        result,
+        beforeLeaves,
+        targetLeaves,
+        beforeCanvas,
+        targetCanvas,
+        lengthScale,
+        domCoverage,
+        designCoverage,
+        gate,
+        markdown: renderDomChanges({
+            result,
+            beforeLeaves,
+            beforePath: 'current.domdoc.json',
+            targetPath: 'target/winner.layerdoc.json',
+            domCoverage,
+            designCoverage,
+        }),
+    };
+};
+export const writeImproveDomDiff = async (args) => {
+    const [beforeDoc, targetDoc] = await Promise.all([
+        readFile(args.beforePath, 'utf8').then(JSON.parse),
+        readFile(args.targetPath, 'utf8').then(JSON.parse),
+    ]);
+    const computed = computeImproveDomDiff({
+        beforeDoc,
+        targetDoc,
+        ...(args.gatePct === undefined ? {} : { gatePct: args.gatePct }),
+    });
+    await mkdir(args.outDir, { recursive: true });
+    const gatePath = path.join(args.outDir, 'GATE.md');
+    const diffPath = path.join(args.outDir, 'diff.json');
+    const changesPath = path.join(args.outDir, 'changes.md');
+    if (!computed.gate.passed) {
+        await Promise.all([
+            rm(diffPath, { force: true }),
+            rm(changesPath, { force: true }),
+            rm(path.join(args.outDir, 'plan-annotated.md'), { force: true }),
+            rm(path.join(args.outDir, 'token-patch.css'), { force: true }),
+        ]);
+        await writeFile(gatePath, renderImproveGate({
+            gate: computed.gate,
+            result: computed.result,
+            beforePath: args.beforePath,
+            targetPath: args.targetPath,
+            designCoverage: computed.designCoverage,
+        }), 'utf8');
+        return { ...computed, artifacts: [gatePath] };
+    }
+    await rm(gatePath, { force: true });
+    await writeFile(diffPath, `${JSON.stringify({
+        generatedAt: new Date().toISOString(),
+        before: args.beforePath,
+        after: args.targetPath,
+        frames: { lengthScale: computed.lengthScale },
+        gate: computed.gate,
+        domCoverage: computed.domCoverage,
+        designCoverage: computed.designCoverage,
+        ...computed.result,
+    }, null, 2)}\n`, 'utf8');
+    await writeFile(changesPath, computed.markdown, 'utf8');
+    return { ...computed, artifacts: [diffPath, changesPath] };
+};
+//# sourceMappingURL=improve-dom-diff.js.map

package/dist/improve-dom-diff.js.map

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

package/dist/improve-dom-extract.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Browser-side DOM walker. Playwright serializes this function, so it must be
+ * self-contained. It emits a LayerDoc-v2-shaped document whose leaves carry
+ * selectors verified against the captured page. Text `box` is glyph ink;
+ * `layoutBox` preserves the element rectangle. It emits visible painted
+ * leaves only, keeps direct text beside block/control children, suppresses a
+ * surface identical to its nearest painted ancestor, records rendered rather
+ * than declared alignment/text, and gives fixed/sticky leaves the viewport
+ * frame. These are the measured pilot caveats; especially, DOM and design
+ * extraction indices never share an identity space.
+ */
+export declare const extractImproveDomInPage: (options: {
+    fullPage: boolean;
+}) => unknown;
+//# sourceMappingURL=improve-dom-extract.d.ts.map

package/dist/improve-dom-extract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"improve-dom-extract.d.ts","sourceRoot":"","sources":["../src/improve-dom-extract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,uBAAuB,GAAI,SAAS;IAAE,QAAQ,EAAE,OAAO,CAAA;CAAE,KAAG,OA2UxE,CAAC"}