@swiftbrowser/cli 0.1.0 → 0.2.0

package/dist/objc.js

@@ -0,0 +1,319 @@
+// Objective-C idioms that Swift without the Objective-C runtime rejects, and
+// how a source is adjusted so it compiles for the browser. Each rewrite keeps
+// every line where it was (diagnostics keep their places): what is added goes
+// on an existing line, and what is removed becomes blank lines.
+//
+// - `@objc` protocols are class-bound, and their `optional` requirements
+//   become plain requirements with default implementations
+//   (`objcProtocols`); calls written for an optional requirement
+//   (`delegate?.method?(…)`) call it plainly (`optionalRequirementCalls`).
+// - An `override` in an extension, which Swift allows only for `@objc`
+//   members, is removed: the superclass's member stays
+//   (`extensionOverrides`).
+// - `#keyPath(Type.property)` becomes the string `"property"`, which is all
+//   key-value coding on Apple platforms takes from it (`keyPathStrings`).
+import { matchingBrace } from './stage.js';
+const ATTRIBUTE = String.raw `@[A-Za-z_][A-Za-z0-9_]*(?:\([^()\n]*(?:\([^()\n]*\)[^()\n]*)*\))?`;
+const ACCESS = String.raw `(?:public|package|internal|fileprivate|private|open)`;
+/** An `@objc` protocol's head, up to its `{`. */
+const OBJC_PROTOCOL = new RegExp(String.raw `^([ \t]*)((?:${ATTRIBUTE}[ \t]+|${ATTRIBUTE}[ \t]*\r?\n[ \t]*)*)(?:(${ACCESS})[ \t]+)?protocol[ \t]+([A-Za-z_][A-Za-z0-9_]*)([^{\n]*)\{`, 'gm');
+/** An `optional` requirement inside a protocol body: its attributes, then `optional`, then `func` or `var`. */
+const OPTIONAL_REQUIREMENT = new RegExp(String.raw `((?:${ATTRIBUTE}[ \t]+)*)\boptional[ \t]+(?=(?:${ATTRIBUTE}[ \t]+)*(?:func|var|static|class)\b)`, 'g');
+/**
+ * `@objc protocol Delegate { @objc optional func didFinish() }` →
+ * `protocol Delegate: AnyObject { func didFinish() } extension Delegate { func didFinish() {} }`
+ * (the extension on the line of the closing brace).
+ *
+ * A default answers what an unimplemented optional requirement left to its
+ * caller as nil: nothing for `Void`, `nil` for an optional, and the type's
+ * zero for the common value types (`false`, `0`, `""`, empty collections).
+ * A call that read nil as "not implemented" (`delegate?.isEnabled ?? true`)
+ * now gets that zero instead. A requirement of another type has no value to
+ * answer and traps if a conformer leaves it out.
+ */
+export function objcProtocols(text) {
+    if (!/@objc\b/.test(text) || !/\bprotocol\b/.test(text))
+        return text;
+    let result = '';
+    let index = 0;
+    OBJC_PROTOCOL.lastIndex = 0;
+    for (;;) {
+        OBJC_PROTOCOL.lastIndex = index;
+        const match = OBJC_PROTOCOL.exec(text);
+        if (!match)
+            break;
+        const attributes = match[2] ?? '';
+        const open = match.index + match[0].length - 1;
+        if (!/@objc\b/.test(attributes)) {
+            result += text.slice(index, open + 1);
+            index = open + 1;
+            continue;
+        }
+        const close = matchingBrace(text, open);
+        if (close < 0)
+            break;
+        const access = match[3];
+        const name = match[4];
+        const inheritance = match[5];
+        // The head, class-bound: Objective-C protocols are.
+        const headStart = match.index + match[0].length - 1 - inheritance.length;
+        result += text.slice(index, headStart);
+        result += classBound(inheritance);
+        result += '{';
+        const body = text.slice(open + 1, close);
+        const defaults = [];
+        let rewritten = '';
+        let bodyIndex = 0;
+        for (const requirement of body.matchAll(OPTIONAL_REQUIREMENT)) {
+            const start = requirement.index;
+            if (start < bodyIndex)
+                continue;
+            const attrs = requirement[1] ?? '';
+            const declaration = requirementAt(body, start + requirement[0].length);
+            const above = attributeLinesAbove(body, start);
+            if (declaration && unavailableInSwift(above.text + attrs)) {
+                // Obsoleted in Swift (a renamed Objective-C spelling): nothing calls
+                // it, and only an `@objc` protocol may have unavailable members.
+                rewritten += body.slice(bodyIndex, above.start) + blank(body.slice(above.start, declaration.end));
+                bodyIndex = declaration.end;
+                continue;
+            }
+            rewritten += body.slice(bodyIndex, start) + attrs;
+            bodyIndex = start + requirement[0].length;
+            if (declaration)
+                defaults.push(defaultImplementation(above.text + attrs, declaration));
+        }
+        result += rewritten + body.slice(bodyIndex);
+        const publicAccess = access === 'public' || access === 'open' ? 'public ' : '';
+        result += '}';
+        if (defaults.length > 0)
+            result += `; ${publicAccess}extension ${name} { ${defaults.join('; ')} }`;
+        index = close + 1;
+    }
+    result += text.slice(index);
+    return result;
+}
+/** The lines just above `offset` that hold only attributes (or comments), and where they start. */
+function attributeLinesAbove(body, offset) {
+    let start = body.lastIndexOf('\n', offset - 1) + 1;
+    // Only when the requirement starts its line (after its own attributes).
+    if (body.slice(start, offset).trim() !== '')
+        return { start: offset, text: '' };
+    const attributeLine = new RegExp(String.raw `^[ \t]*(?:(?:${ATTRIBUTE})[ \t]*)+(?://.*)?\r?$|^[ \t]*//.*$`);
+    let text = '';
+    while (start > 0) {
+        const previousStart = body.lastIndexOf('\n', start - 2) + 1;
+        const line = body.slice(previousStart, start - 1);
+        if (!attributeLine.test(line))
+            break;
+        if (!/^[ \t]*\/\//.test(line))
+            text = `${line.trim()} ${text}`;
+        start = previousStart;
+    }
+    return { start, text };
+}
+/** Whether the attributes make a declaration unavailable to Swift (`@available(swift, obsoleted: 1)`, `@available(*, unavailable)`). */
+function unavailableInSwift(attributes) {
+    return /@available\(\s*swift\s*,[^)]*\bobsoleted\b/.test(attributes) || /@available\(\s*\*\s*,[^)]*\bunavailable\b/.test(attributes);
+}
+/** `text` with everything but its line breaks removed. */
+function blank(text) {
+    return text.replace(/[^\n]/g, '');
+}
+/** `: NSObjectProtocol ` → `: NSObjectProtocol, AnyObject `; nothing → `: AnyObject `. */
+function classBound(inheritance) {
+    if (/\b(?:AnyObject|class)\b/.test(inheritance))
+        return inheritance;
+    const where = /\bwhere\b/.exec(inheritance);
+    const clause = where ? inheritance.slice(0, where.index) : inheritance;
+    const rest = where ? inheritance.slice(where.index) : '';
+    if (/:/.test(clause))
+        return `${clause.replace(/\s*$/, '')}, AnyObject ${rest}`.replace(/\s+$/, ' ');
+    return `${clause.replace(/\s*$/, '')}: AnyObject ${rest}`.replace(/\s+$/, ' ');
+}
+/** The requirement declared at `start` (just after `optional `). */
+function requirementAt(body, start) {
+    const rest = body.slice(start);
+    const funcMatch = /^((?:[A-Za-z_@][^\n(]*?)?\bfunc[ \t]+[^(\n]+)\(/.exec(rest);
+    if (funcMatch) {
+        const open = funcMatch[0].length - 1;
+        const close = matchingParenthesis(rest, open);
+        if (close < 0)
+            return undefined;
+        // What follows the parameters: effects and a result, up to the end of
+        // the line (or the next line when it continues with `->`).
+        const after = rest.slice(close + 1);
+        const lineEnd = after.indexOf('\n');
+        let tail = lineEnd < 0 ? after : after.slice(0, lineEnd);
+        let length = close + 1 + tail.length;
+        if (!/->/.test(tail) && lineEnd >= 0) {
+            const next = after.slice(lineEnd + 1).split('\n')[0] ?? '';
+            if (/^\s*(?:->|async\b|throws\b|rethrows\b)/.test(next)) {
+                tail = `${tail} ${next}`;
+                length += 1 + next.length;
+            }
+        }
+        tail = tail.replace(/\/\/.*$/, '').replace(/\{.*$/, '').trim();
+        const signature = `${rest.slice(0, close + 1)} ${tail}`.replace(/\s+/g, ' ').trim();
+        const arrow = /->\s*(.+?)(?:\s+where\b.*)?$/.exec(tail);
+        return { signature, kind: 'func', end: start + length, type: arrow?.[1]?.trim(), settable: false };
+    }
+    const varMatch = /^((?:[A-Za-z_@][^\n]*?)?\bvar[ \t]+[A-Za-z_][A-Za-z0-9_]*[ \t]*:[ \t]*([^{\n]+?))[ \t]*\{([^}]*)\}/.exec(rest);
+    if (varMatch) {
+        return { signature: varMatch[1].replace(/\s+/g, ' ').trim(), kind: 'var', end: start + varMatch[0].length, type: varMatch[2].trim(), settable: /\bset\b/.test(varMatch[3]) };
+    }
+    return undefined;
+}
+function matchingParenthesis(text, open) {
+    let depth = 0;
+    for (let i = open; i < text.length; i += 1) {
+        if (text[i] === '(')
+            depth += 1;
+        else if (text[i] === ')') {
+            depth -= 1;
+            if (depth === 0)
+                return i;
+        }
+    }
+    return -1;
+}
+/** The default implementation of an optional requirement, on one line. */
+function defaultImplementation(attributes, requirement) {
+    const kept = attributes.replace(/@objc\b(?:\([^)\n]*\))?[ \t]*/g, '').replace(/\s+/g, ' ').trim();
+    const value = zeroValue(requirement.type);
+    const prefix = kept ? `${kept} ` : '';
+    if (requirement.kind === 'func') {
+        const body = value === undefined ? '' : ` ${value} `;
+        return `${prefix}${requirement.signature} {${body}}`;
+    }
+    const getter = value ?? 'fatalError("no default for an optional requirement")';
+    return requirement.settable
+        ? `${prefix}${requirement.signature} { get { ${getter} } set {} }`
+        : `${prefix}${requirement.signature} { ${getter} }`;
+}
+/** What a default answers for `type`: undefined for none (`Void`). */
+function zeroValue(type) {
+    if (!type || type === 'Void' || type === '()')
+        return undefined;
+    if (/[?!]$/.test(type) || /^Optional</.test(type))
+        return 'nil';
+    if (type === 'Bool')
+        return 'false';
+    if (/^(?:U?Int(?:8|16|32|64)?|Double|Float|CGFloat|TimeInterval|NSInteger|NSUInteger)$/.test(type))
+        return '0';
+    if (type === 'String')
+        return '""';
+    if (/^\[[^:\]]*\]$/.test(type))
+        return '[]';
+    if (/^\[.*:.*\]$/.test(type))
+        return '[:]';
+    return `fatalError("no default for an optional requirement returning ${type.replace(/"/g, '')}")`;
+}
+/** The names of the `optional` requirements the sources declare. */
+export function optionalRequirementNames(texts) {
+    const names = new Set();
+    const pattern = /\boptional[ \t]+(?:@[A-Za-z_]+[ \t]+)*(?:static[ \t]+|class[ \t]+)?(?:func|var)[ \t]+([A-Za-z_][A-Za-z0-9_]*)/g;
+    for (const text of texts) {
+        for (const match of text.matchAll(pattern))
+            names.add(match[1]);
+    }
+    return names;
+}
+/**
+ * Calls of optional requirements, as plain calls: `delegate?.method?(…)` →
+ * `delegate?.method(…)`, `delegate.method?(…)` → `delegate.method(…)`, and
+ * `if let impl = delegate.method {` → `if let impl = Optional(delegate.method) {`
+ * (the requirement is always there now).
+ */
+export function optionalRequirementCalls(text, names) {
+    if (names.size === 0)
+        return text;
+    let out = text;
+    for (const name of names) {
+        if (!out.includes(name))
+            continue;
+        out = out.replace(new RegExp(String.raw `\.${name}\?(\s*\()`, 'g'), `.${name}$1`);
+        out = out.replace(new RegExp(String.raw `\b((?:if|guard)[ \t]+(?:let|var)[ \t]+[A-Za-z_][A-Za-z0-9_]*[ \t]*=[ \t]*)([A-Za-z_][\w.?]*\.${name})(?=[ \t]*(?:\{|,|else\b))`, 'g'), '$1Optional($2)');
+    }
+    return out;
+}
+/**
+ * Blanks every `override` member declared in an extension. Swift allows
+ * one only for an `@objc` member of the superclass (`description`,
+ * `isEqual(_:)` on NSObject subclasses), which needs the Objective-C
+ * runtime; without it, the superclass's member stays.
+ */
+export function extensionOverrides(text) {
+    if (!/\boverride\b/.test(text) || !/\bextension\b/.test(text))
+        return text;
+    const extensionHead = new RegExp(String.raw `^[ \t]*(?:${ATTRIBUTE}[ \t]+)*(?:${ACCESS}[ \t]+)?extension[ \t]+[^{\n]*\{`, 'gm');
+    const blanks = [];
+    for (const match of text.matchAll(extensionHead)) {
+        const open = match.index + match[0].length - 1;
+        const close = matchingBrace(text, open);
+        if (close < 0)
+            continue;
+        // Members at the extension's top level.
+        let i = open + 1;
+        while (i < close) {
+            const lineEnd = text.indexOf('\n', i);
+            const end = lineEnd < 0 || lineEnd > close ? close : lineEnd;
+            const line = text.slice(i, end);
+            const member = new RegExp(String.raw `^[ \t]*(?:(?:${ATTRIBUTE}|${ACCESS}(?:\(set\))?|final|dynamic|@objc)[ \t]+)*override\b[^{\n]*\{`).exec(line);
+            if (member) {
+                const braceOpen = i + member[0].length - 1;
+                const braceClose = matchingBrace(text, braceOpen);
+                if (braceClose < 0 || braceClose > close)
+                    break;
+                // Attribute lines just above go with it.
+                let start = i;
+                for (;;) {
+                    if (start === 0 || text[start - 1] !== '\n')
+                        break;
+                    const previousStart = text.lastIndexOf('\n', start - 2) + 1;
+                    if (previousStart <= open || !new RegExp(String.raw `^[ \t]*${ATTRIBUTE}[ \t]*\r?$`).test(text.slice(previousStart, start - 1)))
+                        break;
+                    start = previousStart;
+                }
+                blanks.push([start, braceClose + 1]);
+                const next = text.indexOf('\n', braceClose);
+                i = next < 0 ? close : next + 1;
+                continue;
+            }
+            // Skip nested bodies (a member's body is not the extension's top level).
+            const brace = line.indexOf('{');
+            if (brace >= 0) {
+                const nestedClose = matchingBrace(text, i + brace);
+                if (nestedClose < 0 || nestedClose > close)
+                    break;
+                const next = text.indexOf('\n', nestedClose);
+                i = next < 0 ? close : next + 1;
+                continue;
+            }
+            i = end + 1;
+        }
+    }
+    if (blanks.length === 0)
+        return text;
+    let result = '';
+    let index = 0;
+    for (const [start, end] of blanks.sort((a, b) => a[0] - b[0])) {
+        if (start < index)
+            continue;
+        result += text.slice(index, start) + text.slice(start, end).replace(/[^\n]/g, '');
+        index = end;
+    }
+    return result + text.slice(index);
+}
+/** `#keyPath(Type.isFinished)` → `"isFinished"`; `#keyPath(model.name)` → `"model.name"`. */
+export function keyPathStrings(text) {
+    if (!text.includes('#keyPath'))
+        return text;
+    return text.replace(/#keyPath\(\s*([A-Za-z_][\w.]*)\s*\)/g, (_, path) => {
+        const parts = path.split('.');
+        if (parts.length > 1 && /^[A-Z]/.test(parts[0]))
+            parts.shift();
+        return JSON.stringify(parts.join('.'));
+    });
+}
+//# sourceMappingURL=objc.js.map

package/dist/objc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"objc.js","sourceRoot":"","sources":["../src/objc.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,8EAA8E;AAC9E,8EAA8E;AAC9E,gEAAgE;AAChE,EAAE;AACF,yEAAyE;AACzE,2DAA2D;AAC3D,iEAAiE;AACjE,2EAA2E;AAC3E,uEAAuE;AACvE,uDAAuD;AACvD,4BAA4B;AAC5B,4EAA4E;AAC5E,0EAA0E;AAE1E,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAA,mEAAmE,CAAC;AAChG,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAA,sDAAsD,CAAC;AAEhF,iDAAiD;AACjD,MAAM,aAAa,GAAG,IAAI,MAAM,CAC9B,MAAM,CAAC,GAAG,CAAA,gBAAgB,SAAS,UAAU,SAAS,2BAA2B,MAAM,4DAA4D,EACnJ,IAAI,CACL,CAAC;AAEF,+GAA+G;AAC/G,MAAM,oBAAoB,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,CAAA,OAAO,SAAS,kCAAkC,SAAS,sCAAsC,EAAE,GAAG,CAAC,CAAC;AAE1J;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACrE,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,aAAa,CAAC,SAAS,GAAG,CAAC,CAAC;IAC5B,SAAS,CAAC;QACR,aAAa,CAAC,SAAS,GAAG,KAAK,CAAC;QAChC,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,KAAK;YAAE,MAAM;QAClB,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAClC,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;QAC/C,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC;YACtC,KAAK,GAAG,IAAI,GAAG,CAAC,CAAC;YACjB,SAAS;QACX,CAAC;QACD,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACxC,IAAI,KAAK,GAAG,CAAC;YAAE,MAAM;QACrB,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACxB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QACvB,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QAC9B,oDAAoD;QACpD,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC;QACzE,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QACvC,MAAM,IAAI,UAAU,CAAC,WAAW,CAAC,CAAC;QAClC,MAAM,IAAI,GAAG,CAAC;QACd,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;QACzC,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,IAAI,SAAS,GAAG,EAAE,CAAC;QACnB,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,KAAK,MAAM,WAAW,IAAI,IAAI,CAAC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,CAAC;YAC9D,MAAM,KAAK,GAAG,WAAW,CAAC,KAAM,CAAC;YACjC,IAAI,KAAK,GAAG,SAAS;gBAAE,SAAS;YAChC,MAAM,KAAK,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YACnC,MAAM,WAAW,GAAG,aAAa,CAAC,IAAI,EAAE,KAAK,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;YACvE,MAAM,KAAK,GAAG,mBAAmB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAC/C,IAAI,WAAW,IAAI,kBAAkB,CAAC,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,EAAE,CAAC;gBAC1D,qEAAqE;gBACrE,iEAAiE;gBACjE,SAAS,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;gBAClG,SAAS,GAAG,WAAW,CAAC,GAAG,CAAC;gBAC5B,SAAS;YACX,CAAC;YACD,SAAS,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,GAAG,KAAK,CAAC;YAClD,SAAS,GAAG,KAAK,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;YAC1C,IAAI,WAAW;gBAAE,QAAQ,CAAC,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC,IAAI,GAAG,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC;QACzF,CAAC;QACD,MAAM,IAAI,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAC5C,MAAM,YAAY,GAAG,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/E,MAAM,IAAI,GAAG,CAAC;QACd,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;YAAE,MAAM,IAAI,KAAK,YAAY,aAAa,IAAI,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;QACnG,KAAK,GAAG,KAAK,GAAG,CAAC,CAAC;IACpB,CAAC;IACD,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC5B,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,mGAAmG;AACnG,SAAS,mBAAmB,CAAC,IAAY,EAAE,MAAc;IACvD,IAAI,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;IACnD,wEAAwE;IACxE,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IAChF,MAAM,aAAa,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,CAAA,gBAAgB,SAAS,qCAAqC,CAAC,CAAC;IAC3G,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,OAAO,KAAK,GAAG,CAAC,EAAE,CAAC;QACjB,MAAM,aAAa,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;QAC5D,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QAClD,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,MAAM;QACrC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,IAAI,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC;QAC/D,KAAK,GAAG,aAAa,CAAC;IACxB,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACzB,CAAC;AAED,wIAAwI;AACxI,SAAS,kBAAkB,CAAC,UAAkB;IAC5C,OAAO,4CAA4C,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,2CAA2C,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;AACvI,CAAC;AAED,0DAA0D;AAC1D,SAAS,KAAK,CAAC,IAAY;IACzB,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AACpC,CAAC;AAED,0FAA0F;AAC1F,SAAS,UAAU,CAAC,WAAmB;IACrC,IAAI,yBAAyB,CAAC,IAAI,CAAC,WAAW,CAAC;QAAE,OAAO,WAAW,CAAC;IACpE,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC;IACvE,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACzD,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,eAAe,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACrG,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,eAAe,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AACjF,CAAC;AAaD,oEAAoE;AACpE,SAAS,aAAa,CAAC,IAAY,EAAE,KAAa;IAChD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC/B,MAAM,SAAS,GAAG,iDAAiD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/E,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;QACrC,MAAM,KAAK,GAAG,mBAAmB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC9C,IAAI,KAAK,GAAG,CAAC;YAAE,OAAO,SAAS,CAAC;QAChC,sEAAsE;QACtE,2DAA2D;QAC3D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QACpC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,IAAI,GAAG,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QACzD,IAAI,MAAM,GAAG,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;QACrC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,EAAE,CAAC;YACrC,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAC3D,IAAI,wCAAwC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACxD,IAAI,GAAG,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC;gBACzB,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;YAC5B,CAAC;QACH,CAAC;QACD,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC/D,MAAM,SAAS,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QACpF,MAAM,KAAK,GAAG,8BAA8B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxD,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,GAAG,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IACrG,CAAC;IACD,MAAM,QAAQ,GAAG,oGAAoG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjI,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAE,CAAC,EAAE,CAAC;IAClL,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,mBAAmB,CAAC,IAAY,EAAE,IAAY;IACrD,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3C,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG;YAAE,KAAK,IAAI,CAAC,CAAC;aAC3B,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;YACzB,KAAK,IAAI,CAAC,CAAC;YACX,IAAI,KAAK,KAAK,CAAC;gBAAE,OAAO,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IACD,OAAO,CAAC,CAAC,CAAC;AACZ,CAAC;AAED,0EAA0E;AAC1E,SAAS,qBAAqB,CAAC,UAAkB,EAAE,WAAwB;IACzE,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,CAAC,gCAAgC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAClG,MAAM,KAAK,GAAG,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACtC,IAAI,WAAW,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAChC,MAAM,IAAI,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC;QACrD,OAAO,GAAG,MAAM,GAAG,WAAW,CAAC,SAAS,KAAK,IAAI,GAAG,CAAC;IACvD,CAAC;IACD,MAAM,MAAM,GAAG,KAAK,IAAI,sDAAsD,CAAC;IAC/E,OAAO,WAAW,CAAC,QAAQ;QACzB,CAAC,CAAC,GAAG,MAAM,GAAG,WAAW,CAAC,SAAS,YAAY,MAAM,aAAa;QAClE,CAAC,CAAC,GAAG,MAAM,GAAG,WAAW,CAAC,SAAS,MAAM,MAAM,IAAI,CAAC;AACxD,CAAC;AAED,sEAAsE;AACtE,SAAS,SAAS,CAAC,IAAwB;IACzC,IAAI,CAAC,IAAI,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAChE,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAChE,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO,OAAO,CAAC;IACpC,IAAI,mFAAmF,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,GAAG,CAAC;IAC/G,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACnC,IAAI,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5C,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3C,OAAO,gEAAgE,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC;AACpG,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,wBAAwB,CAAC,KAAuB;IAC9D,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,MAAM,OAAO,GAAG,gHAAgH,CAAC;IACjI,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;YAAE,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,IAAY,EAAE,KAA0B;IAC/E,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAClC,IAAI,GAAG,GAAG,IAAI,CAAC;IACf,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,SAAS;QAClC,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,CAAA,KAAK,IAAI,WAAW,EAAE,GAAG,CAAC,EAAE,IAAI,IAAI,IAAI,CAAC,CAAC;QACjF,GAAG,GAAG,GAAG,CAAC,OAAO,CACf,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,CAAA,gGAAgG,IAAI,4BAA4B,EAAE,GAAG,CAAC,EAC3J,gBAAgB,CACjB,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC3E,MAAM,aAAa,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,CAAA,aAAa,SAAS,cAAc,MAAM,kCAAkC,EAAE,IAAI,CAAC,CAAC;IAC/H,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,GAAG,KAAK,CAAC,KAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;QAChD,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACxC,IAAI,KAAK,GAAG,CAAC;YAAE,SAAS;QACxB,wCAAwC;QACxC,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC;QACjB,OAAO,CAAC,GAAG,KAAK,EAAE,CAAC;YACjB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YACtC,MAAM,GAAG,GAAG,OAAO,GAAG,CAAC,IAAI,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC;YAC7D,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YAChC,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,CAAA,gBAAgB,SAAS,IAAI,MAAM,8DAA8D,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAClJ,IAAI,MAAM,EAAE,CAAC;gBACX,MAAM,SAAS,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;gBAC3C,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;gBAClD,IAAI,UAAU,GAAG,CAAC,IAAI,UAAU,GAAG,KAAK;oBAAE,MAAM;gBAChD,yCAAyC;gBACzC,IAAI,KAAK,GAAG,CAAC,CAAC;gBACd,SAAS,CAAC;oBACR,IAAI,KAAK,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,IAAI;wBAAE,MAAM;oBACnD,MAAM,aAAa,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;oBAC5D,IAAI,aAAa,IAAI,IAAI,IAAI,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,CAAA,UAAU,SAAS,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;wBAAE,MAAM;oBACtI,KAAK,GAAG,aAAa,CAAC;gBACxB,CAAC;gBACD,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC;gBACrC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;gBAC5C,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;gBAChC,SAAS;YACX,CAAC;YACD,yEAAyE;YACzE,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAChC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;gBACf,MAAM,WAAW,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC;gBACnD,IAAI,WAAW,GAAG,CAAC,IAAI,WAAW,GAAG,KAAK;oBAAE,MAAM;gBAClD,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;gBAC7C,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;gBAChC,SAAS;YACX,CAAC;YACD,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC;QACd,CAAC;IACH,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACrC,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9D,IAAI,KAAK,GAAG,KAAK;YAAE,SAAS;QAC5B,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAClF,KAAK,GAAG,GAAG,CAAC;IACd,CAAC;IACD,OAAO,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AACpC,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5C,OAAO,IAAI,CAAC,OAAO,CAAC,sCAAsC,EAAE,CAAC,CAAC,EAAE,IAAY,EAAE,EAAE;QAC9E,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC;YAAE,KAAK,CAAC,KAAK,EAAE,CAAC;QAChE,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/packagePatches.d.ts

@@ -0,0 +1,24 @@
+export interface PackageEdit {
+    /** The file, relative to the package's root. */
+    file: string;
+    /** What it does, for the build log and the error. */
+    why: string;
+    /** The exact passage, found once in the file. */
+    find: string;
+    replace: string;
+}
+export interface PackagePatch {
+    /** The release the patch was written for. */
+    version: string;
+    edits: readonly PackageEdit[];
+}
+/** Patches by SwiftPM identity. */
+export declare const PACKAGE_PATCHES: Readonly<Record<string, PackagePatch>>;
+/**
+ * Checks that every edit of `patch` applies to the package at `packageDir`
+ * (its passage is in its file exactly once), and throws a `CliError` naming
+ * the first that does not.
+ */
+export declare function checkPatch(identity: string, version: string, packageDir: string, patch: PackagePatch): void;
+/** `text` (the file at `relative` in the package) with the patch's edits of it applied. */
+export declare function applyPatch(patch: PackagePatch | undefined, relative: string, text: string): string;

package/dist/packagePatches.js

@@ -0,0 +1,107 @@
+// Edits SwiftBrowser makes to a package's sources before building it against
+// the shim, for what neither the shim nor the source adjustments (stage.ts,
+// objc.ts) can cover: code that only works with the Objective-C runtime or
+// relies on Apple's type identities. Each edit replaces one exact passage of
+// one file, in the package as published, before the usual adjustments; the
+// copy is changed, never SwiftPM's checkout. A replacement keeps the
+// passage's line count (it is padded with blank lines), so diagnostics in
+// the rest of the file keep their places.
+//
+// A patch is written against one release. When a passage is not in the
+// resolved version exactly once, the build stops and says which: the patch
+// has to be brought up to date for that release (or the package pinned to
+// the release it was written for).
+import { existsSync, readFileSync } from 'node:fs';
+import path from 'node:path';
+import { CliError } from './log.js';
+const lines = (...parts) => parts.join('\n');
+/** Patches by SwiftPM identity. */
+export const PACKAGE_PATCHES = {
+    // RevenueCat's SDK (the product `RevenueCat`). Its purchases go to StoreKit,
+    // which in the browser has no products and refuses payments
+    // (Sources/StoreKit); its backend is reached over URLSession.
+    'purchases-ios-spm': {
+        version: '5.92.0',
+        edits: [
+            {
+                file: 'Sources/Attribution/ASIdManagerProxy.swift',
+                why: 'the advertising identifier: a method called on a class found by name (none is found)',
+                find: 'return classType.sharedManager().value(forKey: Self.mangledIdentifierPropertyName.rot13()) as? UUID',
+                replace: '_ = classType; return nil',
+            },
+            {
+                file: 'Sources/Attribution/TrackingManagerProxy.swift',
+                why: 'the tracking authorization: a method called on a class found by name (none is found)',
+                find: 'return classType.trackingAuthorizationStatus()',
+                replace: '_ = classType; return 0',
+            },
+            {
+                file: 'Sources/Attribution/AttributionFetcher.swift',
+                why: 'the tracking authorization through a method implementation (IMP) cast to a C function: not determined',
+                find: lines('        typealias ClosureType = @convention(c) (AnyObject, Selector) -> FakeTrackingManagerAuthorizationStatus', '        let authStatusMethodImplementation = trackingManagerProxy.method(for: authStatusSelector)', '        let authStatusMethod: ClosureType = unsafeBitCast(authStatusMethodImplementation, to: ClosureType.self)', '        let authStatus = authStatusMethod(trackingManagerProxy, authStatusSelector)', '        return authStatus'),
+                replace: '        return .notDetermined',
+            },
+            {
+                file: 'Sources/Support/ManageSubscriptionsHelper.swift',
+                why: "opening the management URL through UIApplication's openURL method implementation: UIApplication.open instead",
+                find: lines('        typealias ClosureType = @convention(c) (AnyObject, Selector, NSURL, NSDictionary?, Any?) -> Void', '', '        let selector: Selector = NSSelectorFromString("openURL:options:completionHandler:")', '        let methodIMP: IMP! = application.method(for: selector)', '        let openURLMethod = unsafeBitCast(methodIMP, to: ClosureType.self)', '        openURLMethod(application, selector, url as NSURL, nil, nil)'),
+                replace: '        Task { @MainActor in application.open(url) }',
+            },
+            {
+                file: 'Sources/Error Handling/PurchasesError.swift',
+                why: 'an initializer overloaded on [NSError.UserInfoKey: Any], which is [String: Any] here',
+                find: lines('    init(error: ErrorCode, userInfo: [NSError.UserInfoKey: Any]) {', '        self.init(error: error, userInfo: userInfo as [String: Any])', '    }'),
+                replace: '',
+            },
+            {
+                file: 'Sources/Error Handling/ErrorUtils.swift',
+                why: 'a method overloaded on [NSError.UserInfoKey: Any], which is [String: Any] here',
+                find: lines('    @_disfavoredOverload', '    func addingUserInfo<Result: NSError>(_ userInfo: [NSError.UserInfoKey: Any]) -> Result {', '        return self.addingUserInfo(userInfo as [String: Any])', '    }'),
+                replace: '',
+            },
+            {
+                file: 'Sources/Error Handling/ErrorUtils.swift',
+                why: "an NSError subclass made from its metatype, which needs a required initializer corelibs' NSError lacks",
+                find: lines('        return .init(domain: nsError.domain,', '                     code: nsError.code,', '                     userInfo: nsError.userInfo + userInfo)'),
+                replace: lines('        return NSError(domain: nsError.domain,', '                       code: nsError.code,', '                       userInfo: nsError.userInfo + userInfo) as! Result'),
+            },
+        ],
+    },
+};
+/** `replace`, padded with line breaks to `find`'s line count. */
+function padded(edit) {
+    const missing = edit.find.split('\n').length - edit.replace.split('\n').length;
+    if (missing < 0)
+        throw new Error(`a patch edit of ${edit.file} adds lines`);
+    return edit.replace + '\n'.repeat(missing);
+}
+/**
+ * Checks that every edit of `patch` applies to the package at `packageDir`
+ * (its passage is in its file exactly once), and throws a `CliError` naming
+ * the first that does not.
+ */
+export function checkPatch(identity, version, packageDir, patch) {
+    for (const edit of patch.edits) {
+        const file = path.join(packageDir, edit.file);
+        const text = existsSync(file) ? readFileSync(file, 'utf8') : undefined;
+        const count = text === undefined ? 0 : text.split(edit.find).length - 1;
+        if (count === 1)
+            continue;
+        const problem = text === undefined ? 'the file is not there' : count === 0 ? 'the passage it replaces is not there' : `the passage it replaces is there ${count} times`;
+        throw new CliError(`SwiftBrowser's patch for ${identity} does not apply to ${version}: ${edit.file}, ${edit.why}: ${problem}. ` +
+            `The patch was written for ${patch.version}; pin the package to ${patch.version} in Xcode, or update the patch (packages/cli/src/packagePatches.ts).`);
+    }
+}
+/** `text` (the file at `relative` in the package) with the patch's edits of it applied. */
+export function applyPatch(patch, relative, text) {
+    if (!patch)
+        return text;
+    const normalized = relative.split(path.sep).join('/');
+    let out = text;
+    for (const edit of patch.edits) {
+        if (edit.file === normalized)
+            out = out.replace(edit.find, () => padded(edit));
+    }
+    return out;
+}
+//# sourceMappingURL=packagePatches.js.map

package/dist/packagePatches.js.map

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

package/dist/packages.d.ts

@@ -0,0 +1,59 @@
+import { type SwiftPackageReference, type SwiftPackageRequirement } from '@swiftbrowser/xcodeproj';
+import type { ConfigPackage } from './config.js';
+/** A package the app target links, with the products it links from it. */
+export interface AppPackage {
+    /** Absent when the project names the product but no package (or folder holding a `Package.swift`) provides it. */
+    reference?: SwiftPackageReference;
+    products: string[];
+}
+/**
+ * Packages the shim stands in for, by SwiftPM identity, with the reason the
+ * real one cannot be used and the products it provides. Each product is a
+ * module of the SwiftBrowser package (Sources/<Product>), listed in
+ * `STAND_IN_FRAMEWORKS`. When another package depends on one, the staging
+ * gives that package a redirect in its place (vendor.ts).
+ */
+export declare const PACKAGE_STAND_INS: Readonly<Record<string, PackageStandIn>>;
+export interface PackageStandIn {
+    reason: string;
+    products: readonly string[];
+}
+export type PackagePlan = 
+/** Not fetched: the shim's module of the same name is linked instead. */
+{
+    kind: 'stand-in';
+    package: AppPackage;
+    reason: string;
+}
+/** Fetched and built by SwiftPM: `declaration` goes in the manifest's `dependencies`. */
+ | {
+    kind: 'dependency';
+    package: AppPackage;
+    identity: string;
+    declaration: string;
+}
+/** Left out, with what is missing; the build reports the imports that fail. */
+ | {
+    kind: 'unresolved';
+    package: AppPackage;
+    problem: string;
+};
+/** `swiftbrowser.json`'s packages (config.ts), as the Xcode project's are: paths relative to `root`. */
+export declare function configPackages(packages: readonly ConfigPackage[], root: string): AppPackage[];
+/** Groups a target's package products by package, in the order the project lists them. */
+export declare function groupPackageProducts(dependencies: readonly {
+    product: string;
+    package?: SwiftPackageReference;
+}[]): AppPackage[];
+/** What the staging does with each package (`standIns` for tests: none today). */
+export declare function planPackages(packages: readonly AppPackage[], standIns?: Readonly<Record<string, PackageStandIn>>): PackagePlan[];
+/** Xcode's dependency rule as the argument of SwiftPM's `.package(url:…)`. */
+export declare function requirementArgument(requirement: SwiftPackageRequirement): string;
+/** The rule in words, as Xcode's package list shows it. */
+export declare function describeRequirement(requirement: SwiftPackageRequirement): string;
+/** A package as people name it: the URL's last component (case kept), or the folder. */
+export declare function packageDisplayName(entry: AppPackage): string;
+/** Where a package comes from, and on what rule, for the `check` report. */
+export declare function packageSource(entry: AppPackage): string;
+/** Module names the dependency packages provide, guessed as their product names → the package's name. */
+export declare function packageModules(plans: readonly PackagePlan[]): Map<string, string>;