@swiftbrowser/cli 0.1.0

package/dist/project.js

@@ -0,0 +1,264 @@
+// Working out what to build from what the user points at: an `.xcodeproj`, a
+// folder holding one, or a plain folder of Swift sources; plus the optional
+// `swiftbrowser.json`.
+import { existsSync, readdirSync, statSync } from 'node:fs';
+import path from 'node:path';
+import { loadConfig } from './config.js';
+import { CliError } from './log.js';
+/** Directories never searched for sources or catalogs. */
+const SKIP_DIRS = new Set(['.build', '.swiftbrowser', '.git', 'node_modules', 'DerivedData', 'Pods', 'Carthage', 'build', 'Preview Content']);
+/** `Guess The Flag` → `GuessTheFlag`; a leading digit gets an underscore. */
+export function moduleName(raw) {
+    const cleaned = raw.replace(/[^A-Za-z0-9_]+/g, '');
+    if (!cleaned)
+        return 'App';
+    return /^[0-9]/.test(cleaned) ? `_${cleaned}` : cleaned;
+}
+function walk(dir, visit) {
+    for (const entry of readdirSync(dir, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name))) {
+        const full = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            if (SKIP_DIRS.has(entry.name) || entry.name.startsWith('.') || /(Tests|UITests)$/.test(entry.name))
+                continue;
+            if (entry.name.endsWith('.xcassets') || entry.name.endsWith('.xcodeproj') || entry.name.endsWith('.xcworkspace')) {
+                visit(full, statSync(full));
+                continue;
+            }
+            walk(full, visit);
+        }
+        else if (entry.isFile()) {
+            visit(full, statSync(full));
+        }
+    }
+}
+/** Every `.swift` file and `.xcassets` folder under `dir`, by convention. */
+export function discoverByConvention(dir) {
+    const sources = [];
+    const catalogs = [];
+    walk(dir, (file) => {
+        if (file.endsWith('.swift') && !/(Tests|UITests)\.swift$/.test(path.basename(file)) && !/Package\.swift$/.test(file))
+            sources.push(file);
+        else if (file.endsWith('.xcassets'))
+            catalogs.push(file);
+    });
+    return { sources, catalogs };
+}
+/** Swift files named by a config `sources` list: files as is, directories recursively. */
+function expandSources(root, entries) {
+    const out = [];
+    for (const entry of entries) {
+        const full = path.resolve(root, entry);
+        if (!existsSync(full))
+            throw new CliError(`sources entry not found: ${entry}`);
+        if (statSync(full).isDirectory())
+            out.push(...discoverByConvention(full).sources);
+        else
+            out.push(full);
+    }
+    return out;
+}
+function applyExcludes(root, files, exclude) {
+    if (!exclude || exclude.length === 0)
+        return files;
+    const prefixes = exclude.map((entry) => path.resolve(root, entry));
+    return files.filter((file) => !prefixes.some((prefix) => file === prefix || file.startsWith(`${prefix}${path.sep}`)));
+}
+/** The largest PNG of the app icon set, for the home-screen manifest. */
+export function findAppIcon(catalogs, iconName = 'AppIcon') {
+    for (const catalog of catalogs) {
+        const set = path.join(catalog, `${iconName}.appiconset`);
+        if (!existsSync(set))
+            continue;
+        const pngs = readdirSync(set)
+            .filter((name) => name.toLowerCase().endsWith('.png'))
+            .map((name) => path.join(set, name))
+            .sort((a, b) => statSync(b).size - statSync(a).size);
+        if (pngs[0])
+            return pngs[0];
+    }
+    return undefined;
+}
+/** `.xcodeproj` bundles directly in `dir`, else one level down. */
+export function xcodeProjectsIn(dir) {
+    const direct = readdirSync(dir, { withFileTypes: true }).filter((e) => e.isDirectory() && e.name.endsWith('.xcodeproj')).map((e) => path.join(dir, e.name));
+    if (direct.length > 0)
+        return direct.sort();
+    const nested = [];
+    for (const entry of readdirSync(dir, { withFileTypes: true })) {
+        if (!entry.isDirectory() || SKIP_DIRS.has(entry.name) || entry.name.startsWith('.'))
+            continue;
+        for (const inner of readdirSync(path.join(dir, entry.name), { withFileTypes: true })) {
+            if (inner.isDirectory() && inner.name.endsWith('.xcodeproj'))
+                nested.push(path.join(dir, entry.name, inner.name));
+        }
+    }
+    return nested.sort();
+}
+/** Resources Xcode compiles rather than copies; nothing the browser could read. */
+const COMPILED_RESOURCE = /\.(xcassets|storyboard|xib|xcdatamodeld?|intentdefinition|mlmodel|mlmodelc|metal|strings|stringsdict|lproj|entitlements|xcstrings)$/;
+/** The Xcode target's copied resources: everything but asset catalogs and compiled resources, in project order. */
+export function bundleResources(resources) {
+    const out = [];
+    for (const file of resources) {
+        if (COMPILED_RESOURCE.test(file) || path.basename(file) === 'Info.plist' || out.includes(file))
+            continue;
+        out.push(file);
+    }
+    return out;
+}
+/** Loaded lazily so the folder path needs no Xcode project reader. */
+async function readXcode(projectPath) {
+    const mod = (await import('@swiftbrowser/xcodeproj'));
+    return mod.readXcodeProject(projectPath);
+}
+/** Resolves `input` (an .xcodeproj, a folder with one, or a folder of sources) to an app. */
+export async function resolveApp(input, options = {}) {
+    const target = path.resolve(input);
+    if (!existsSync(target))
+        throw new CliError(`not found: ${input}`);
+    let projectPath = null;
+    let root;
+    if (target.endsWith('.xcodeproj')) {
+        projectPath = target;
+        root = path.dirname(target);
+    }
+    else {
+        if (!statSync(target).isDirectory())
+            throw new CliError(`${input} is neither a folder nor an .xcodeproj`);
+        root = target;
+        const projects = xcodeProjectsIn(target);
+        if (projects.length > 1) {
+            throw new CliError(`${input} holds several Xcode projects; point at one:\n  ${projects.map((p) => path.relative(target, p)).join('\n  ')}`);
+        }
+        if (projects.length === 1) {
+            projectPath = projects[0];
+            root = path.dirname(projectPath);
+        }
+    }
+    const config = loadConfig(root, options.configFile);
+    const swiftLanguageMode = config.swiftLanguageMode ?? '5';
+    const foundation = options.foundation ?? config.foundation ?? 'full';
+    const defines = config.defines ?? [];
+    const locales = config.locales ?? ['en'];
+    if (projectPath) {
+        const project = await readXcode(projectPath);
+        const apps = project.appTargets();
+        const wanted = options.target ?? config.target;
+        let chosen;
+        if (wanted) {
+            chosen = project.targets.find((t) => t.name === wanted);
+            if (!chosen)
+                throw new CliError(`no target "${wanted}" in ${path.basename(projectPath)}; targets: ${project.targets.map((t) => t.name).join(', ')}`);
+        }
+        else if (apps.length === 1) {
+            chosen = apps[0];
+        }
+        else if (apps.length === 0) {
+            throw new CliError(`${path.basename(projectPath)} has no iOS app target (targets: ${project.targets.map((t) => t.name).join(', ') || 'none'})`);
+        }
+        else {
+            throw new CliError(`${path.basename(projectPath)} has several app targets; pick one with --target:\n  ${apps.map((t) => t.name).join('\n  ')}`);
+        }
+        if (!chosen)
+            throw new CliError('no target chosen');
+        const sources = applyExcludes(root, config.sources ? expandSources(root, config.sources) : chosen.sources.filter((f) => f.endsWith('.swift')), config.exclude);
+        const catalogs = config.catalogs ? config.catalogs.map((c) => path.resolve(root, c)) : chosen.assetCatalogs;
+        const resources = config.resources ? config.resources.map((r) => path.resolve(root, r)) : bundleResources(chosen.resources ?? []);
+        const icon = config.icon ? path.resolve(root, config.icon) : findAppIcon(catalogs, chosen.appIconName);
+        const app = {
+            name: config.name ?? moduleName(chosen.productName || chosen.name),
+            displayName: config.displayName ?? chosen.displayName ?? chosen.productName ?? chosen.name,
+            root,
+            sources,
+            catalogs,
+            resources,
+            swiftLanguageMode: config.swiftLanguageMode ?? (chosen.swiftVersion?.startsWith('6') ? '6' : swiftLanguageMode),
+            foundation,
+            locales,
+            defines,
+            origin: { kind: 'xcodeproj', project: projectPath, target: chosen.name },
+        };
+        if (icon)
+            app.icon = icon;
+        return finish(app);
+    }
+    const discovered = discoverByConvention(root);
+    const sources = applyExcludes(root, config.sources ? expandSources(root, config.sources) : discovered.sources, config.exclude);
+    const catalogs = config.catalogs ? config.catalogs.map((c) => path.resolve(root, c)) : discovered.catalogs;
+    // A plain folder has no Copy Bundle Resources phase: resources come from the config only.
+    const resources = (config.resources ?? []).map((r) => path.resolve(root, r));
+    const icon = config.icon ? path.resolve(root, config.icon) : findAppIcon(catalogs);
+    const app = {
+        name: config.name ?? moduleName(path.basename(root)),
+        displayName: config.displayName ?? path.basename(root),
+        root,
+        sources,
+        catalogs,
+        resources,
+        swiftLanguageMode,
+        foundation,
+        locales,
+        defines,
+        origin: { kind: 'folder' },
+    };
+    if (icon)
+        app.icon = icon;
+    return finish(app);
+}
+/**
+ * The path as it exists on disk when it differs only in case: Xcode projects
+ * made on macOS (a case-insensitive disk) may say `BucketList/` for a folder
+ * named `Bucketlist/`. Each missing component is matched case-insensitively
+ * against its directory; the path comes back unchanged when nothing matches.
+ */
+export function repairCase(file) {
+    if (existsSync(file))
+        return file;
+    const parts = file.split(path.sep);
+    let current = path.isAbsolute(file) ? path.sep : '';
+    for (const part of parts) {
+        if (part === '')
+            continue;
+        const candidate = path.join(current, part);
+        if (existsSync(candidate)) {
+            current = candidate;
+            continue;
+        }
+        if (!existsSync(current))
+            return file;
+        const match = readdirSync(current).find((entry) => entry.toLowerCase() === part.toLowerCase());
+        if (match === undefined)
+            return file;
+        current = path.join(current, match);
+    }
+    return current;
+}
+function finish(app) {
+    if (app.sources.length === 0)
+        throw new CliError(`no Swift sources found for ${app.name} in ${app.root}`);
+    // An Xcode project made on macOS can name files whose case differs from the
+    // disk's; repair what can be repaired, report the rest.
+    app.sources = app.sources.map(repairCase);
+    app.catalogs = app.catalogs.map(repairCase);
+    app.resources = app.resources.map(repairCase);
+    if (app.icon)
+        app.icon = repairCase(app.icon);
+    const missing = app.sources.filter((file) => !existsSync(file));
+    if (missing.length > 0) {
+        throw new CliError(`${missing.length} source file${missing.length === 1 ? '' : 's'} named by the project ${missing.length === 1 ? 'does' : 'do'} not exist:\n  ${missing.join('\n  ')}`);
+    }
+    const missingResources = app.resources.filter((file) => !existsSync(file));
+    if (missingResources.length > 0) {
+        throw new CliError(`${missingResources.length} resource${missingResources.length === 1 ? '' : 's'} named by the project ${missingResources.length === 1 ? 'does' : 'do'} not exist:\n  ${missingResources.join('\n  ')}`);
+    }
+    const names = new Map();
+    for (const file of app.sources) {
+        const base = path.basename(file);
+        const other = names.get(base);
+        if (other)
+            throw new CliError(`two sources share the file name ${base} (Swift needs unique names in a module):\n  ${other}\n  ${file}`);
+        names.set(base, file);
+    }
+    return app;
+}
+//# sourceMappingURL=project.js.map

package/dist/project.js.map

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

package/dist/stage.d.ts

@@ -0,0 +1,78 @@
+import { type ICUData } from './icu.js';
+import type { ResolvedApp } from './project.js';
+export interface StagedApp {
+    /** The staging package directory (holds Package.swift, Sources/, .build/). */
+    dir: string;
+    /** Staged file → original file, for mapping compiler diagnostics back. */
+    originals: Map<string, string>;
+    /** `#Preview` blocks removed, in total. */
+    previewsStripped: number;
+}
+/** Where an app's staging package lives. */
+export declare function stagingDir(app: ResolvedApp): string;
+/** The built module, optimized or not. */
+export declare function wasmOutput(app: ResolvedApp): string;
+export interface TransformResult {
+    text: string;
+    previewsStripped: number;
+    /** `import Foundation` lines rewritten. */
+    foundationRewrites: number;
+}
+/**
+ * Adjusts one source for the shim without moving any line, so compiler
+ * diagnostics keep their line numbers:
+ * - `import SwiftUI` also imports the Foundation modules (lean: FoundationEssentials
+ *   + FoundationLite; full: Foundation + FoundationBridge), as Apple's SwiftUI
+ *   re-exports Foundation;
+ * - lean: `import Foundation` → `import FoundationEssentials; import FoundationLite`,
+ *   which is what the SwiftBrowser examples import by hand; in both modes the
+ *   line also imports Observation (Apple's Foundation re-exports it, so
+ *   `@Observable` works in a file that imports Foundation alone);
+ * - full: `import FoundationLite` → `import FoundationBridge` (the examples'
+ *   `#if canImport(FoundationEssentials)` branch, against the real Foundation);
+ * - `#Preview { … }` blocks (and `#Preview("name", traits: …) { … }`) become
+ *   blank lines: the shim has no preview macro and previews are not part of
+ *   the app.
+ */
+export declare function transformSource(text: string, options: {
+    foundation: 'lean' | 'full';
+}): TransformResult;
+/** Replaces every `#Preview …{ … }` block with blank lines of the same count. */
+export declare function stripPreviews(text: string): {
+    text: string;
+    count: number;
+};
+/** Index of the `}` closing the `{` at `open`, skipping strings and comments; -1 when unbalanced. */
+export declare function matchingBrace(text: string, open: number): number;
+/** The Package.swift of the staging package. */
+export declare function packageManifest(app: ResolvedApp, swiftPackagePath: string): string;
+/** The staged file that settles names declared by both the shim and Foundation. */
+export declare const FULL_FOUNDATION_FILE = "_SwiftBrowserFoundation.swift";
+/**
+ * In full mode the app imports both the shim and the real Foundation, and
+ * both declare a few names (the shim cannot import Foundation itself, which
+ * would link it into every lean app; and a module does not shadow another's
+ * declarations, only the current module's do). A typealias in the app module
+ * does: these point the shared names at the shim's types (what its
+ * `frame(width:)` and friends take) and at FoundationBridge's `Timer` and
+ * `RunLoop`, which Foundation lacks on WASI (`RunLoop` is marked unavailable,
+ * its `Timer` needs CFRunLoop and does not link).
+ */
+export declare function fullFoundationSource(): string;
+/** The directory the staged sources keep their layout relative to. */
+export declare function commonSourceBase(app: ResolvedApp): string;
+export interface StageOptions {
+    /**
+     * The trimmed ICU data for a full-Foundation wasm build (`prepareICUData`);
+     * without it a full-mode staging builds on the host only.
+     */
+    icu?: ICUData | null;
+}
+/**
+ * Writes (or refreshes) the staging package. Files are written only when
+ * their content changed, so SwiftPM's incremental build stays incremental;
+ * staged files whose source is gone are removed.
+ */
+export declare function stage(app: ResolvedApp, swiftPackagePath: string, options?: StageOptions): StagedApp;
+/** Rewrites staged paths in compiler output back to the user's files. */
+export declare function remapDiagnostics(output: string, staged: StagedApp): string;