multiclone 0.2.1 → 0.3.0

package/dist/project/convert/jsx.js

@@ -0,0 +1,335 @@
+import { BOOLEAN, htmlPropName, isTypedProp, NUMERIC, styleKey, svgPropName } from './attrs.js';
+import { decodeEntities, innerHtml } from './html.js';
+export function newJsxState() {
+    return { unknownTags: new Set(), cssProperties: false };
+}
+const DROP = new Set(['script', 'noscript', 'link', 'meta', 'base', 'title', 'head']);
+const BLOCK = new Set('address article aside blockquote body dd details dialog div dl dt fieldset figcaption figure footer form h1 h2 h3 h4 h5 h6 header hgroup hr li main nav ol p pre section summary table tbody td tfoot th thead tr ul video canvas iframe picture source style template'.split(' '));
+const VOID = new Set([
+    'area',
+    'base',
+    'br',
+    'col',
+    'embed',
+    'hr',
+    'img',
+    'input',
+    'link',
+    'meta',
+    'param',
+    'source',
+    'track',
+    'wbr',
+]);
+/** Tags in React's JSX.IntrinsicElements; anything else is declared by the converter. */
+const KNOWN = new Set('a abbr address area article aside audio b base bdi bdo big blockquote body br button canvas caption center cite code col colgroup data datalist dd del details dfn dialog div dl dt em embed fieldset figcaption figure footer form h1 h2 h3 h4 h5 h6 head header hgroup hr html i iframe img input ins kbd keygen label legend li link main map mark menu menuitem meta meter nav noindex noscript object ol optgroup option output p param picture pre progress q rp rt ruby s samp search slot script section select small source span strong style sub summary sup table template tbody td textarea tfoot th thead time title tr track u ul var video wbr webview svg animate animateMotion animateTransform circle clipPath defs desc ellipse filter foreignObject g image line linearGradient marker mask metadata mpath path pattern polygon polyline radialGradient rect set stop switch symbol text textPath tspan use view'.split(' '));
+const SVG_TYPED = new Set('className id style viewBox d fill stroke strokeWidth strokeLinecap strokeLinejoin strokeMiterlimit strokeDasharray strokeDashoffset strokeOpacity fillRule fillOpacity clipRule clipPath clipPathUnits mask maskUnits maskContentUnits opacity transform x y x1 x2 y1 y2 cx cy r rx ry fx fy width height points offset stopColor stopOpacity gradientUnits gradientTransform spreadMethod href xlinkHref preserveAspectRatio patternUnits patternContentUnits patternTransform filter filterUnits primitiveUnits stdDeviation in in2 result mode operator values type dx dy textAnchor dominantBaseline fontFamily fontSize fontWeight letterSpacing pathLength markerWidth markerHeight markerUnits orient refX refY xmlSpace xmlnsXlink focusable role tabIndex vectorEffect colorInterpolationFilters floodColor floodOpacity lightingColor visibility display overflow shapeRendering imageRendering textRendering paintOrder'.split(' '));
+const ARIA_TYPED = new Set([
+    'aria-label',
+    'aria-labelledby',
+    'aria-describedby',
+    'aria-controls',
+    'aria-owns',
+    'aria-roledescription',
+]);
+const ARIA_BOOL = new Set([
+    'aria-hidden',
+    'aria-expanded',
+    'aria-selected',
+    'aria-checked',
+    'aria-pressed',
+    'aria-disabled',
+    'aria-modal',
+    'aria-busy',
+    'aria-required',
+    'aria-readonly',
+    'aria-atomic',
+]);
+const URL_ATTRS = new Set([
+    'src',
+    'href',
+    'poster',
+    'data',
+    'data-src',
+    'data-bg',
+    'data-background',
+    'data-poster',
+    'data-video-src',
+    'xlink:href',
+]);
+const SRCSET_ATTRS = new Set(['srcset', 'data-srcset', 'imagesrcset']);
+/** JSX for a node's children. */
+export function renderChildren(parent, options, state) {
+    const kids = parent.children.filter((node) => node.kind === 'text' || !DROP.has(node.tag));
+    const preserve = parent.tag === 'pre' || hasPreAncestor(parent);
+    let out = '';
+    kids.forEach((node, index) => {
+        if (node.kind === 'element') {
+            const prev = kids[index - 1];
+            if (prev?.kind === 'element')
+                out += '\n';
+            out += renderElement(node, options, state);
+            return;
+        }
+        const text = decodeEntities(node.raw);
+        if (preserve) {
+            if (text)
+                out += `{${JSON.stringify(text)}}`;
+            return;
+        }
+        const collapsed = text.replace(/[\t\n\r\f ]+/g, ' ');
+        const prev = kids[index - 1];
+        const next = kids[index + 1];
+        if (collapsed === ' ') {
+            if (!prev || !next)
+                return;
+            if ((prev.kind === 'element' && BLOCK.has(prev.tag)) ||
+                (next.kind === 'element' && BLOCK.has(next.tag)))
+                return;
+            out += "{' '}";
+            return;
+        }
+        let body = collapsed;
+        const lead = body.startsWith(' ') && prev !== undefined;
+        const trail = body.endsWith(' ') && next !== undefined;
+        body = body.trim();
+        out += `${lead ? "{' '}" : ''}${escapeText(body)}${trail ? "{' '}" : ''}`;
+    });
+    return out;
+}
+function hasPreAncestor(node) {
+    for (let at = node.parent; at; at = at.parent)
+        if (at.tag === 'pre')
+            return true;
+    return false;
+}
+function escapeText(text) {
+    return text
+        .replace(/&/g, '&')
+        .replace(/[{}<>]/g, (ch) => `{'${ch}'}`)
+        .replace(/\u00a0/g, '&nbsp;');
+}
+/** JSX for one element (and its subtree). */
+export function renderElement(node, options, state) {
+    const replaced = options.replace?.(node);
+    if (replaced !== null && replaced !== undefined)
+        return replaced;
+    if (node.tag.includes(':') && !node.foreign)
+        return renderChildren(node, options, state);
+    const tag = node.tag;
+    if (!KNOWN.has(tag) && !(node.foreign && /^fe[A-Z]/.test(tag)))
+        state.unknownTags.add(tag);
+    const loose = state.unknownTags.has(tag);
+    const props = renderProps(node, options, state, loose);
+    const open = `<${tag}${props ? ` ${props}` : ''}`;
+    if (tag === 'textarea') {
+        const value = decodeEntities(node.children.map((child) => (child.kind === 'text' ? child.raw : '')).join(''));
+        return `${open}${value ? ` defaultValue={${JSON.stringify(value)}}` : ''} />`;
+    }
+    if (tag === 'style') {
+        const css = node.children.map((child) => (child.kind === 'text' ? child.raw : '')).join('');
+        return `${open}>{${JSON.stringify(rewriteStyleUrls(css, options))}}</${tag}>`;
+    }
+    if (tag === 'template') {
+        return `${open} dangerouslySetInnerHTML={{ __html: ${JSON.stringify(innerHtml(node))} }} />`;
+    }
+    if (VOID.has(tag) && !node.foreign)
+        return `${open} />`;
+    const inner = renderChildren(node, options, state);
+    return inner ? `${open}>${inner}</${tag}>` : `${open} />`;
+}
+function renderProps(node, options, state, loose) {
+    const direct = [];
+    const spread = [];
+    const seen = new Set();
+    for (const [rawName, rawValue] of node.attrs) {
+        const name = node.foreign ? rawName : rawName.toLowerCase();
+        if (seen.has(name))
+            continue;
+        seen.add(name);
+        // setAttribute rejects these characters (Alpine `@click`, Vue `:class`); the DOM never saw them as data either.
+        if (!/^[a-zA-Z_][\w\-:.]*$/.test(name))
+            continue;
+        let value = decodeEntities(rawValue);
+        if (/^on[a-z]+$/.test(name)) {
+            direct.push(`data-mc-${name}=${quote(value)}`);
+            continue;
+        }
+        if (name === 'style') {
+            const style = renderStyle(value, options, state);
+            if (style)
+                direct.push(`style={${style}}`);
+            continue;
+        }
+        if (URL_ATTRS.has(name) &&
+            value &&
+            !value.startsWith('#') &&
+            !/^(data|javascript|mailto|tel|blob):/i.test(value))
+            value = options.url(value, name === 'href' && !node.foreign && node.tag !== 'link' ? 'link' : 'resource');
+        if (SRCSET_ATTRS.has(name))
+            value = rewriteSrcset(value, options);
+        if (name === 'class')
+            value = value.replace(/\s+/g, ' ').trim();
+        if (node.foreign) {
+            const prop = svgPropName(name);
+            if (prop && SVG_TYPED.has(prop))
+                direct.push(`${prop}=${quote(value)}`);
+            else if (prop?.includes('-') && /^[a-zA-Z][\w-]*$/.test(prop))
+                direct.push(`${prop}=${quote(value)}`);
+            else
+                spread.push([name, value]);
+            continue;
+        }
+        if (name.startsWith('aria-')) {
+            if (ARIA_TYPED.has(name) || (ARIA_BOOL.has(name) && (value === 'true' || value === 'false')))
+                direct.push(`${name}=${quote(value)}`);
+            else
+                spread.push([name, value]);
+            continue;
+        }
+        if (name.includes('-') && !name.includes(':') && /^[a-zA-Z][\w-]*$/.test(name)) {
+            direct.push(`${name}=${quote(value)}`);
+            continue;
+        }
+        let prop = htmlPropName(name);
+        if (/^(input|select|textarea)$/.test(node.tag) && (prop === 'value' || prop === 'checked')) {
+            if (prop === 'value')
+                direct.push(`defaultValue=${quote(value)}`);
+            else
+                direct.push('defaultChecked');
+            continue;
+        }
+        if (node.tag === 'option' && name === 'selected')
+            continue;
+        if (loose) {
+            if (prop === 'className' || /^[a-zA-Z][\w]*$/.test(prop))
+                direct.push(`${prop}=${quote(value)}`);
+            else
+                spread.push([name, value]);
+            continue;
+        }
+        if (BOOLEAN.has(prop) && (value === '' || value.toLowerCase() === name || value === 'true')) {
+            if (isTypedProp(node.tag, prop, '')) {
+                direct.push(prop);
+                continue;
+            }
+        }
+        if (!BOOLEAN.has(prop) && isTypedProp(node.tag, prop, value)) {
+            direct.push(NUMERIC.has(prop) ? `${prop}={${String(Number(value.trim()))}}` : `${prop}=${quote(value)}`);
+            continue;
+        }
+        if (prop === 'className') {
+            direct.push(`className=${quote(value)}`);
+            continue;
+        }
+        prop = name;
+        spread.push([prop, value]);
+    }
+    if (spread.length) {
+        const entries = spread
+            .map(([key, value]) => `${JSON.stringify(key)}: ${JSON.stringify(value)}`)
+            .join(', ');
+        direct.push(`{...({ ${entries} } as Record<string, string>)}`);
+    }
+    return direct.join(' ');
+}
+function quote(value) {
+    // JSX attribute strings cannot hold escapes; expressions can.
+    return /["\\\n\r{}]|&/.test(value) || value.includes("'")
+        ? `{${JSON.stringify(value)}}`
+        : `"${value}"`;
+}
+function renderStyle(source, options, state) {
+    const entries = [];
+    let custom = false;
+    for (const decl of splitDecls(source)) {
+        const colon = decl.indexOf(':');
+        if (colon <= 0)
+            continue;
+        const property = decl.slice(0, colon).trim();
+        let value = decl
+            .slice(colon + 1)
+            .trim()
+            .replace(/\s*!important\s*$/i, '');
+        if (!property || !value)
+            continue;
+        value = rewriteStyleUrls(value, options);
+        const key = styleKey(property);
+        if (key.startsWith('--'))
+            custom = true;
+        entries.push(`${/^[a-zA-Z_$][\w$]*$/.test(key) ? key : JSON.stringify(key)}: ${JSON.stringify(value)}`);
+    }
+    if (!entries.length)
+        return null;
+    if (custom)
+        state.cssProperties = true;
+    const object = `{ ${entries.join(', ')} }`;
+    return custom ? `${object} as CSSProperties` : object;
+}
+function splitDecls(source) {
+    const out = [];
+    let depth = 0;
+    let quoteChar = '';
+    let start = 0;
+    for (let i = 0; i < source.length; i++) {
+        const ch = source[i];
+        if (quoteChar) {
+            if (ch === '\\')
+                i++;
+            else if (ch === quoteChar)
+                quoteChar = '';
+            continue;
+        }
+        if (ch === '"' || ch === "'")
+            quoteChar = ch;
+        else if (ch === '(')
+            depth++;
+        else if (ch === ')')
+            depth = Math.max(0, depth - 1);
+        else if (ch === ';' && depth === 0) {
+            out.push(source.slice(start, i));
+            start = i + 1;
+        }
+    }
+    out.push(source.slice(start));
+    return out.map((decl) => decl.trim()).filter(Boolean);
+}
+/** url(...) inside inline styles and <style> blocks, rewritten like resource attributes. */
+export function rewriteStyleUrls(css, options) {
+    return css.replace(/url\(\s*(["']?)([^"')]*)\1\s*\)/gi, (match, _quote, url) => {
+        const raw = url.trim();
+        if (!raw || /^(data|blob):/i.test(raw) || raw.startsWith('#'))
+            return match;
+        return `url('${options.url(raw, 'resource')}')`;
+    });
+}
+/** srcset candidates (`a.png 1x, b.png 2x`), each URL rewritten; data: URLs stay whole. */
+export function rewriteSrcset(value, options) {
+    const out = [];
+    let i = 0;
+    while (i < value.length) {
+        while (i < value.length && /[\s,]/.test(value[i] ?? ''))
+            i++;
+        if (i >= value.length)
+            break;
+        let end = i;
+        while (end < value.length && !/\s/.test(value[end] ?? ''))
+            end++;
+        let url = value.slice(i, end);
+        let descriptor = '';
+        if (url.endsWith(','))
+            url = url.replace(/,+$/, '');
+        else {
+            const comma = value.indexOf(',', end);
+            descriptor = value.slice(end, comma === -1 ? value.length : comma).trim();
+            end = comma === -1 ? value.length : comma;
+        }
+        i = end + 1;
+        if (!url)
+            continue;
+        const local = /^(data|blob):/i.test(url) ? url : options.url(url, 'resource');
+        out.push(descriptor ? `${local} ${descriptor}` : local);
+    }
+    return out.join(', ');
+}
+//# sourceMappingURL=jsx.js.map

package/dist/project/convert/jsx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx.js","sourceRoot":"","sources":["../../../src/project/convert/jsx.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAChG,OAAO,EAAE,cAAc,EAAE,SAAS,EAAoB,MAAM,WAAW,CAAC;AAoBxE,MAAM,UAAU,WAAW;IACzB,OAAO,EAAE,WAAW,EAAE,IAAI,GAAG,EAAE,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;AAC1D,CAAC;AAED,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;AACtF,MAAM,KAAK,GAAG,IAAI,GAAG,CACnB,wQAAwQ,CAAC,KAAK,CAC5Q,GAAG,CACJ,CACF,CAAC;AACF,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC;IACnB,MAAM;IACN,MAAM;IACN,IAAI;IACJ,KAAK;IACL,OAAO;IACP,IAAI;IACJ,KAAK;IACL,OAAO;IACP,MAAM;IACN,MAAM;IACN,OAAO;IACP,QAAQ;IACR,OAAO;IACP,KAAK;CACN,CAAC,CAAC;AAEH,yFAAyF;AACzF,MAAM,KAAK,GAAG,IAAI,GAAG,CACnB,s4BAAs4B,CAAC,KAAK,CAC14B,GAAG,CACJ,CACF,CAAC;AAEF,MAAM,SAAS,GAAG,IAAI,GAAG,CACvB,o4BAAo4B,CAAC,KAAK,CACx4B,GAAG,CACJ,CACF,CAAC;AACF,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC;IACzB,YAAY;IACZ,iBAAiB;IACjB,kBAAkB;IAClB,eAAe;IACf,WAAW;IACX,sBAAsB;CACvB,CAAC,CAAC;AACH,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC;IACxB,aAAa;IACb,eAAe;IACf,eAAe;IACf,cAAc;IACd,cAAc;IACd,eAAe;IACf,YAAY;IACZ,WAAW;IACX,eAAe;IACf,eAAe;IACf,aAAa;CACd,CAAC,CAAC;AACH,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC;IACxB,KAAK;IACL,MAAM;IACN,QAAQ;IACR,MAAM;IACN,UAAU;IACV,SAAS;IACT,iBAAiB;IACjB,aAAa;IACb,gBAAgB;IAChB,YAAY;CACb,CAAC,CAAC;AACH,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,aAAa,EAAE,aAAa,CAAC,CAAC,CAAC;AAEvE,iCAAiC;AACjC,MAAM,UAAU,cAAc,CAAC,MAAmB,EAAE,OAAmB,EAAE,KAAe;IACtF,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3F,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,KAAK,KAAK,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;IAChE,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QAC3B,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;YAC7B,IAAI,IAAI,EAAE,IAAI,KAAK,SAAS;gBAAE,GAAG,IAAI,IAAI,CAAC;YAC1C,GAAG,IAAI,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;YAC3C,OAAO;QACT,CAAC;QACD,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACtC,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,IAAI;gBAAE,GAAG,IAAI,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC;YAC7C,OAAO;QACT,CAAC;QACD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC;QACrD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QAC7B,IAAI,SAAS,KAAK,GAAG,EAAE,CAAC;YACtB,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI;gBAAE,OAAO;YAC3B,IACE,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAChD,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAEhD,OAAO;YACT,GAAG,IAAI,OAAO,CAAC;YACf,OAAO;QACT,CAAC;QACD,IAAI,IAAI,GAAG,SAAS,CAAC;QACrB,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,KAAK,SAAS,CAAC;QACxD,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,IAAI,KAAK,SAAS,CAAC;QACvD,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QACnB,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IAC5E,CAAC,CAAC,CAAC;IACH,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,cAAc,CAAC,IAAiB;IACvC,KAAK,IAAI,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,MAAM;QAAE,IAAI,EAAE,CAAC,GAAG,KAAK,KAAK;YAAE,OAAO,IAAI,CAAC;IACjF,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,UAAU,CAAC,IAAY;IAC9B,OAAO,IAAI;SACR,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;SACtB,OAAO,CAAC,SAAS,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC;SACvC,OAAO,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;AAClC,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,aAAa,CAAC,IAAiB,EAAE,OAAmB,EAAE,KAAe;IACnF,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC;IACzC,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IACjE,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO;QAAE,OAAO,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IACzF,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;IACrB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAAE,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC3F,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IACvD,MAAM,IAAI,GAAG,IAAI,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IAClD,IAAI,GAAG,KAAK,UAAU,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,cAAc,CAC1B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAChF,CAAC;QACF,OAAO,GAAG,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,kBAAkB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC;IAChF,CAAC;IACD,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;QACpB,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC5F,OAAO,GAAG,IAAI,KAAK,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,MAAM,GAAG,GAAG,CAAC;IAChF,CAAC;IACD,IAAI,GAAG,KAAK,UAAU,EAAE,CAAC;QACvB,OAAO,GAAG,IAAI,uCAAuC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC;IAC/F,CAAC;IACD,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO;QAAE,OAAO,GAAG,IAAI,KAAK,CAAC;IACxD,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IACnD,OAAO,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,KAAK,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,CAAC;AAC5D,CAAC;AAED,SAAS,WAAW,CAClB,IAAiB,EACjB,OAAmB,EACnB,KAAe,EACf,KAAc;IAEd,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,MAAM,GAAuB,EAAE,CAAC;IACtC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QAC7C,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;QAC5D,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,SAAS;QAC7B,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACf,gHAAgH;QAChH,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,SAAS;QACjD,IAAI,KAAK,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;QACrC,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5B,MAAM,CAAC,IAAI,CAAC,WAAW,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAC/C,SAAS;QACX,CAAC;QACD,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;YACrB,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;YACjD,IAAI,KAAK;gBAAE,MAAM,CAAC,IAAI,CAAC,UAAU,KAAK,GAAG,CAAC,CAAC;YAC3C,SAAS;QACX,CAAC;QACD,IACE,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC;YACnB,KAAK;YACL,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC;YACtB,CAAC,sCAAsC,CAAC,IAAI,CAAC,KAAK,CAAC;YAEnD,KAAK,GAAG,OAAO,CAAC,GAAG,CACjB,KAAK,EACL,IAAI,KAAK,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,GAAG,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAC9E,CAAC;QACJ,IAAI,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,KAAK,GAAG,aAAa,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAClE,IAAI,IAAI,KAAK,OAAO;YAAE,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QAChE,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;YAC/B,IAAI,IAAI,IAAI,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;iBACnE,IAAI,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,IAAI,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC;gBAC3D,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;;gBACpC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;YAChC,SAAS;QACX,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YAC7B,IAAI,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,OAAO,CAAC,CAAC;gBAC1F,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;;gBACpC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;YAChC,SAAS;QACX,CAAC;QACD,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/E,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACvC,SAAS;QACX,CAAC;QACD,IAAI,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;QAC9B,IAAI,2BAA2B,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,SAAS,CAAC,EAAE,CAAC;YAC3F,IAAI,IAAI,KAAK,OAAO;gBAAE,MAAM,CAAC,IAAI,CAAC,gBAAgB,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;;gBAC7D,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;YACnC,SAAS;QACX,CAAC;QACD,IAAI,IAAI,CAAC,GAAG,KAAK,QAAQ,IAAI,IAAI,KAAK,UAAU;YAAE,SAAS;QAC3D,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,IAAI,KAAK,WAAW,IAAI,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC;gBACtD,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;;gBACpC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;YAChC,SAAS;QACX,CAAC;QACD,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,KAAK,EAAE,IAAI,KAAK,CAAC,WAAW,EAAE,KAAK,IAAI,IAAI,KAAK,KAAK,MAAM,CAAC,EAAE,CAAC;YAC5F,IAAI,WAAW,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC;gBACpC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAClB,SAAS;YACX,CAAC;QACH,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC;YAC7D,MAAM,CAAC,IAAI,CACT,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE,CAC5F,CAAC;YACF,SAAS;QACX,CAAC;QACD,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;YACzB,MAAM,CAAC,IAAI,CAAC,aAAa,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACzC,SAAS;QACX,CAAC;QACD,IAAI,GAAG,IAAI,CAAC;QACZ,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IAC7B,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,MAAM,OAAO,GAAG,MAAM;aACnB,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;aACzE,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,MAAM,CAAC,IAAI,CAAC,UAAU,OAAO,gCAAgC,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,KAAK,CAAC,KAAa;IAC1B,8DAA8D;IAC9D,OAAO,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC;QACvD,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG;QAC9B,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC;AACnB,CAAC;AAED,SAAS,WAAW,CAAC,MAAc,EAAE,OAAmB,EAAE,KAAe;IACvE,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,KAAK,MAAM,IAAI,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,KAAK,IAAI,CAAC;YAAE,SAAS;QACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;QAC7C,IAAI,KAAK,GAAG,IAAI;aACb,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC;aAChB,IAAI,EAAE;aACN,OAAO,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAC;QACrC,IAAI,CAAC,QAAQ,IAAI,CAAC,KAAK;YAAE,SAAS;QAClC,KAAK,GAAG,gBAAgB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACzC,MAAM,GAAG,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC/B,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,MAAM,GAAG,IAAI,CAAC;QACxC,OAAO,CAAC,IAAI,CACV,GAAG,oBAAoB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAC1F,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACjC,IAAI,MAAM;QAAE,KAAK,CAAC,aAAa,GAAG,IAAI,CAAC;IACvC,MAAM,MAAM,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;IAC3C,OAAO,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,mBAAmB,CAAC,CAAC,CAAC,MAAM,CAAC;AACxD,CAAC;AAED,SAAS,UAAU,CAAC,MAAc;IAChC,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,SAAS,GAAG,EAAE,CAAC;IACnB,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACrB,IAAI,SAAS,EAAE,CAAC;YACd,IAAI,EAAE,KAAK,IAAI;gBAAE,CAAC,EAAE,CAAC;iBAChB,IAAI,EAAE,KAAK,SAAS;gBAAE,SAAS,GAAG,EAAE,CAAC;YAC1C,SAAS;QACX,CAAC;QACD,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,GAAG;YAAE,SAAS,GAAG,EAAE,CAAC;aACxC,IAAI,EAAE,KAAK,GAAG;YAAE,KAAK,EAAE,CAAC;aACxB,IAAI,EAAE,KAAK,GAAG;YAAE,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;aAC/C,IAAI,EAAE,KAAK,GAAG,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YACnC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;YACjC,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC;QAChB,CAAC;IACH,CAAC;IACD,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IAC9B,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AACxD,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,gBAAgB,CAAC,GAAW,EAAE,OAAmB;IAC/D,OAAO,GAAG,CAAC,OAAO,CAAC,mCAAmC,EAAE,CAAC,KAAK,EAAE,MAAc,EAAE,GAAW,EAAE,EAAE;QAC7F,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QACvB,IAAI,CAAC,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;QAC5E,OAAO,QAAQ,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,CAAC,IAAI,CAAC;IAClD,CAAC,CAAC,CAAC;AACL,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,aAAa,CAAC,KAAa,EAAE,OAAmB;IAC9D,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;QACxB,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAAE,CAAC,EAAE,CAAC;QAC7D,IAAI,CAAC,IAAI,KAAK,CAAC,MAAM;YAAE,MAAM;QAC7B,IAAI,GAAG,GAAG,CAAC,CAAC;QACZ,OAAO,GAAG,GAAG,KAAK,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;YAAE,GAAG,EAAE,CAAC;QACjE,IAAI,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAC9B,IAAI,UAAU,GAAG,EAAE,CAAC;QACpB,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;aAC/C,CAAC;YACJ,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YACtC,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;YAC1E,GAAG,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC;QAC5C,CAAC;QACD,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC;QACZ,IAAI,CAAC,GAAG;YAAE,SAAS;QACnB,MAAM,KAAK,GAAG,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QAC9E,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,UAAU,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC"}

package/dist/project/convert/locate.js

@@ -0,0 +1,180 @@
+import { attr, elementChildren, textContent } from './html.js';
+const SKIP = new Set(['script', 'style', 'noscript', 'template', 'link', 'meta']);
+/** Element a capture path (`body > div:nth-of-type(2) > main`, `#hero > h1`) points at. */
+export function resolvePath(doc, path) {
+    const steps = (path.split(' >>> ')[0] ?? '').split(/\s*>\s*/).filter(Boolean);
+    let current = null;
+    for (const step of steps) {
+        if (step === 'html') {
+            current = doc.html;
+            continue;
+        }
+        if (step === 'body') {
+            current = doc.body;
+            continue;
+        }
+        if (step.startsWith('#')) {
+            current = findById(doc.root, step.slice(1));
+            if (!current)
+                return null;
+            continue;
+        }
+        const match = /^([a-zA-Z][\w-]*)(?::nth-of-type\((\d+)\))?$/.exec(step);
+        if (!match || !current)
+            return null;
+        const tag = (match[1] ?? '').toLowerCase();
+        const same = elementChildren(current).filter((child) => child.tag.toLowerCase() === tag);
+        const nth = match[2] ? Number(match[2]) : 1;
+        current = same[nth - 1] ?? null;
+        if (!current)
+            return null;
+    }
+    return current;
+}
+function findById(node, id) {
+    if (attr(node, 'id') === id)
+        return node;
+    for (const child of elementChildren(node)) {
+        const found = findById(child, id);
+        if (found)
+            return found;
+    }
+    return null;
+}
+/** Same element in another parse of the page: by id, then tag + class list + leading text. */
+export function counterpart(target, element) {
+    const id = attr(element, 'id');
+    if (id) {
+        const found = findById(target.root, id);
+        if (found)
+            return found;
+    }
+    const cls = (attr(element, 'class') ?? '').trim();
+    if (!cls)
+        return null;
+    const text = textContent(element).replace(/\s+/g, ' ').trim().slice(0, 60);
+    const matches = [];
+    const walk = (node) => {
+        if (node.tag === element.tag && (attr(node, 'class') ?? '').trim() === cls)
+            matches.push(node);
+        for (const child of elementChildren(node))
+            walk(child);
+    };
+    walk(target.body);
+    const sameText = matches.filter((node) => textContent(node).replace(/\s+/g, ' ').trim().slice(0, 60) === text);
+    return (sameText.length === 1 ? sameText[0] : matches.length === 1 ? matches[0] : null) ?? null;
+}
+function contains(outer, inner) {
+    for (let node = inner; node; node = node.parent)
+        if (node === outer)
+            return true;
+    return false;
+}
+/**
+ * Sections from the capture's index, resolved in this document (falling back to a match through
+ * the hydrated DOM), without overlaps, in document order.
+ */
+export function locateSections(doc, index, viewport, hydrated) {
+    const kept = [];
+    for (const entry of index) {
+        const path = entry.viewports[viewport]?.path ?? Object.values(entry.viewports).find(Boolean)?.path;
+        if (!path)
+            continue;
+        let element = resolvePath(doc, path);
+        if (hydrated && hydrated !== doc) {
+            const live = resolvePath(hydrated, path);
+            const twin = live ? counterpart(doc, live) : null;
+            if (twin)
+                element = twin;
+        }
+        if (!element || element === doc.body || element === doc.html)
+            continue;
+        if (kept.some((section) => contains(section.element, element) || contains(element, section.element)))
+            continue;
+        kept.push({ id: entry.id, label: entry.label, element });
+    }
+    const order = documentOrder(doc.body);
+    return kept.sort((a, b) => (order.get(a.element) ?? 0) - (order.get(b.element) ?? 0));
+}
+function documentOrder(root) {
+    const order = new Map();
+    const walk = (node) => {
+        order.set(node, order.size);
+        for (const child of elementChildren(node))
+            walk(child);
+    };
+    walk(root);
+    return order;
+}
+/** Sections when the capture has no split: the visible blocks of <main> (or the body). */
+export function fallbackSections(doc) {
+    const main = findTag(doc.body, 'main');
+    let container = main ?? doc.body;
+    for (let guard = 0; guard < 8; guard++) {
+        const kids = elementChildren(container).filter((child) => !SKIP.has(child.tag));
+        if (kids.length !== 1 || !kids[0])
+            break;
+        container = kids[0];
+    }
+    const blocks = elementChildren(container).filter((child) => !SKIP.has(child.tag) &&
+        (textContent(child).trim() !== '' ||
+            ['img', 'video', 'svg', 'picture', 'canvas'].includes(child.tag)));
+    const chosen = blocks.length > 1 ? blocks : [container];
+    return chosen.map((element, index) => ({
+        id: `block-${String(index + 1)}`,
+        label: labelFor(element) ?? `block ${String(index + 1)}`,
+        element,
+    }));
+}
+function findTag(node, tag) {
+    if (node.tag === tag)
+        return node;
+    for (const child of elementChildren(node)) {
+        const found = findTag(child, tag);
+        if (found)
+            return found;
+    }
+    return null;
+}
+/** Readable name from an element's id, first class or heading. */
+export function labelFor(element) {
+    const id = attr(element, 'id');
+    if (id && !/\d{4,}/.test(id))
+        return id;
+    const heading = findFirst(element, (node) => /^h[1-3]$/.test(node.tag));
+    const text = heading ? textContent(heading).replace(/\s+/g, ' ').trim() : '';
+    if (text)
+        return text.split(' ').slice(0, 4).join(' ');
+    const cls = (attr(element, 'class') ?? '')
+        .split(/\s+/)
+        .find((name) => name && !/^(w-|is-|js-)/.test(name));
+    return cls ?? element.tag;
+}
+function findFirst(node, test) {
+    for (const child of elementChildren(node)) {
+        if (test(child))
+            return child;
+        const found = findFirst(child, test);
+        if (found)
+            return found;
+    }
+    return null;
+}
+/** PascalCase component name (`HeroSection`); never starts with a digit, unique in `taken`. */
+export function componentName(label, suffix, taken) {
+    const words = label
+        .replace(/[^a-zA-Z0-9]+/g, ' ')
+        .trim()
+        .split(/\s+/)
+        .filter(Boolean)
+        .slice(0, 4)
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1).toLowerCase())
+        .join('');
+    const base = !words ? suffix : /^[A-Z]/.test(words) ? `${words}${suffix}` : `${suffix}${words}`;
+    let name = base;
+    for (let n = 2; taken.has(name); n++)
+        name = `${base}${String(n)}`;
+    taken.add(name);
+    return name;
+}
+//# sourceMappingURL=locate.js.map

package/dist/project/convert/locate.js.map

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