@swiftbrowser/cli 0.1.0

package/dist/commands/dev.js

@@ -0,0 +1,83 @@
+// `swiftbrowser dev <path>`: the app in the browser with rebuild on save.
+import { existsSync } from 'node:fs';
+import path from 'node:path';
+import { createDevServer } from '@swiftbrowser/web';
+import { buildWasm, fileSize, formatBytes } from '../build.js';
+import { describeICUData, prepareICUData } from '../icu.js';
+import { CliError, bold, dim, info, ok } from '../log.js';
+import { commonSourceBase, stage, wasmOutput } from '../stage.js';
+import { swiftPackagePath } from '@swiftbrowser/swift';
+import { describeApp, describeReport, prepare, requireToolchain } from './shared.js';
+/** For a full-Foundation app, the trimmed ICU data (made once per SDK and language set, then cached). */
+export function icuDataFor(app, toolchain) {
+    if (app.foundation !== 'full')
+        return null;
+    const icu = prepareICUData(toolchain, app.locales);
+    info(dim(`  ${describeICUData(icu)}`));
+    return icu;
+}
+/** The registry entry the web dev server runs the app from. */
+export function appSpec(app, staged, toolchain, options) {
+    const spec = {
+        name: app.name,
+        displayName: app.displayName,
+        description: app.origin.kind === 'xcodeproj' ? `${path.basename(app.origin.project)} › ${app.origin.target}` : path.basename(app.root),
+        wasm: wasmOutput(app),
+        catalogs: app.catalogs,
+        resources: app.resources,
+        locales: app.locales,
+        watch: [commonSourceBase(app)],
+        build: async () => {
+            // Re-stage first: a saved file is copied (and adjusted) before SwiftPM runs.
+            const fresh = stage(app, swiftPackagePath(), { icu: options.icu ?? null });
+            staged.originals = fresh.originals;
+            await buildWasm({ toolchain, staged: fresh, app, ...(options.wasmOpt ? { wasmOpt: options.wasmOpt } : {}) });
+        },
+    };
+    if (app.icon)
+        spec.icon = app.icon;
+    return spec;
+}
+export async function dev(input, options) {
+    const { app, report, staged } = await prepare(input, options);
+    describeApp(app);
+    describeReport(report, app);
+    const toolchain = requireToolchain({ wasm: true });
+    const spec = appSpec(app, staged, toolchain, { icu: icuDataFor(app, toolchain) });
+    info(dim(`\nbuilding ${app.name} for WebAssembly (Swift ${toolchain.version}, ${staged.dir})…`));
+    const started = Date.now();
+    try {
+        await spec.build();
+    }
+    catch (error) {
+        if (error instanceof CliError) {
+            info(error.message);
+            info(dim('\nfix the errors above; the dev server rebuilds when a source changes'));
+        }
+        else {
+            throw error;
+        }
+    }
+    if (existsSync(spec.wasm)) {
+        info(ok(`${bold(app.name)}.wasm ${dim(`${formatBytes(fileSize(spec.wasm))}, ${((Date.now() - started) / 1000).toFixed(1)} s`)}`));
+    }
+    const serverOptions = { apps: [spec], strictPort: false };
+    if (options.port !== undefined)
+        serverOptions.port = options.port;
+    if (options.host !== undefined)
+        serverOptions.host = options.host;
+    if (options.open !== undefined)
+        serverOptions.open = options.open;
+    const server = await createDevServer(serverOptions);
+    info('');
+    server.printUrls();
+    info(dim(`\n  open /app/?app=${app.name} on this machine, or the landing page's QR code on a phone`));
+    await new Promise((resolve) => {
+        const stop = () => {
+            void server.close().then(resolve);
+        };
+        process.once('SIGINT', stop);
+        process.once('SIGTERM', stop);
+    });
+}
+//# sourceMappingURL=dev.js.map

package/dist/commands/dev.js.map

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

package/dist/commands/doctor.d.ts

@@ -0,0 +1,12 @@
+import { type Toolchain } from '../toolchain.js';
+export interface DoctorOptions {
+    install?: boolean;
+}
+export interface DoctorResult {
+    toolchain: Toolchain | null;
+    wasmSdk: boolean;
+    wasmOpt: string | null;
+    node: boolean;
+}
+export declare const SWIFT_INSTALL_HINT: string;
+export declare function doctor(options?: DoctorOptions): Promise<DoctorResult>;

package/dist/commands/doctor.js

@@ -0,0 +1,66 @@
+// `swiftbrowser doctor [--install]`: is everything a build needs here?
+import { SWIFT_VERSION, WASM_SDK, WASM_SDK_CHECKSUM, WASM_SDK_URL, findToolchain, findWasmOpt, hasWasmSdk, installBinaryen, installWasmSdk } from '../toolchain.js';
+import { bad, bold, dim, info, ok, warn } from '../log.js';
+export const SWIFT_INSTALL_HINT = [
+    `install Swift ${SWIFT_VERSION} with swiftly (https://www.swift.org/install/):`,
+    `    swiftly install ${SWIFT_VERSION} --use`,
+    `  or point SWIFT_TOOLCHAIN_BIN at a toolchain's usr/bin`,
+].join('\n');
+export async function doctor(options = {}) {
+    info(bold('swiftbrowser doctor'));
+    const nodeMajor = Number(process.versions.node.split('.')[0]);
+    const node = nodeMajor >= 22;
+    info(node ? ok(`Node ${process.versions.node}`) : bad(`Node ${process.versions.node}: 22 or newer is needed`));
+    const found = findToolchain();
+    let toolchain = found.toolchain;
+    if (toolchain) {
+        info(ok(`Swift ${toolchain.version} ${dim(toolchain.swift)}`));
+    }
+    else if (found.fallback) {
+        info(bad(`Swift ${found.fallback.version} at ${found.fallback.swift}: SwiftBrowser needs ${SWIFT_VERSION}`));
+        info(`  ${SWIFT_INSTALL_HINT}`);
+    }
+    else {
+        info(bad(`Swift ${SWIFT_VERSION} not found`));
+        info(`  ${SWIFT_INSTALL_HINT}`);
+    }
+    let wasmSdk = false;
+    if (toolchain) {
+        wasmSdk = hasWasmSdk(toolchain);
+        if (wasmSdk) {
+            info(ok(`Swift SDK for WebAssembly ${dim(WASM_SDK)}`));
+        }
+        else if (options.install) {
+            info(`  installing ${WASM_SDK} (about 400 MB)…`);
+            const result = installWasmSdk(toolchain);
+            wasmSdk = result.ok && hasWasmSdk(toolchain);
+            info(wasmSdk ? ok(`Swift SDK for WebAssembly ${dim(WASM_SDK)}`) : bad(`installing the SDK failed:\n${result.output}`));
+        }
+        else {
+            info(bad(`Swift SDK for WebAssembly (${WASM_SDK}) not installed`));
+            info(`  swift sdk install ${WASM_SDK_URL} --checksum ${WASM_SDK_CHECKSUM}`);
+            info(dim('  (or run `swiftbrowser doctor --install`)'));
+        }
+    }
+    let wasmOpt = findWasmOpt();
+    if (wasmOpt) {
+        info(ok(`wasm-opt ${dim(wasmOpt)}`));
+    }
+    else if (options.install) {
+        info('  downloading binaryen…');
+        try {
+            wasmOpt = await installBinaryen();
+            info(ok(`wasm-opt ${dim(wasmOpt)}`));
+        }
+        catch (error) {
+            info(bad(`installing binaryen failed: ${error instanceof Error ? error.message : String(error)}`));
+        }
+    }
+    else {
+        info(warn('wasm-opt not found: `build` ships unoptimized modules (about 2.5× larger); `swiftbrowser doctor --install` downloads binaryen'));
+    }
+    if (toolchain && wasmSdk)
+        info(`\n${ok(bold('ready'))}: swiftbrowser dev <path-to-your-app>`);
+    return { toolchain, wasmSdk, wasmOpt, node };
+}
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

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

package/dist/commands/shared.d.ts

@@ -0,0 +1,23 @@
+import { type CompatReport } from '../compat.js';
+import type { FoundationMode } from '../config.js';
+import { type ResolvedApp } from '../project.js';
+import { type StagedApp } from '../stage.js';
+import { type Toolchain } from '../toolchain.js';
+export interface AppOptions {
+    target?: string;
+    config?: string;
+    foundation?: FoundationMode;
+}
+export interface Prepared {
+    app: ResolvedApp;
+    report: CompatReport;
+    staged: StagedApp;
+}
+/** The required toolchain, or a CliError saying how to get it. */
+export declare function requireToolchain(options: {
+    wasm: boolean;
+}): Toolchain;
+export declare function prepare(input: string, options: AppOptions): Promise<Prepared>;
+export declare function describeApp(app: ResolvedApp): void;
+/** Prints the import report; returns whether anything is known to be unsupported. */
+export declare function describeReport(report: CompatReport, app: ResolvedApp): boolean;

package/dist/commands/shared.js

@@ -0,0 +1,73 @@
+// What `check`, `dev` and `build` share: resolving the app, reporting its
+// imports, staging it and finding the toolchain.
+import path from 'node:path';
+import { swiftPackagePath } from '@swiftbrowser/swift';
+import { compatReport, rewrittenTo } from '../compat.js';
+import { CliError, bad, bold, cyan, dim, info, ok, warn, yellow } from '../log.js';
+import { resolveApp } from '../project.js';
+import { stage } from '../stage.js';
+import { SWIFT_VERSION, findToolchain, hasWasmSdk } from '../toolchain.js';
+import { SWIFT_INSTALL_HINT } from './doctor.js';
+/** The required toolchain, or a CliError saying how to get it. */
+export function requireToolchain(options) {
+    const found = findToolchain();
+    if (!found.toolchain) {
+        const have = found.fallback ? `found Swift ${found.fallback.version} at ${found.fallback.swift}; ` : '';
+        throw new CliError(`${have}SwiftBrowser needs Swift ${SWIFT_VERSION}\n  ${SWIFT_INSTALL_HINT}`);
+    }
+    if (options.wasm && !hasWasmSdk(found.toolchain)) {
+        throw new CliError('the Swift SDK for WebAssembly is not installed; run `swiftbrowser doctor --install`');
+    }
+    return found.toolchain;
+}
+export async function prepare(input, options) {
+    const resolveOptions = {};
+    if (options.target)
+        resolveOptions.target = options.target;
+    if (options.config)
+        resolveOptions.configFile = options.config;
+    if (options.foundation)
+        resolveOptions.foundation = options.foundation;
+    const app = await resolveApp(input, resolveOptions);
+    const report = compatReport(app.sources, app.foundation);
+    const staged = stage(app, swiftPackagePath());
+    return { app, report, staged };
+}
+export function describeApp(app) {
+    const origin = app.origin.kind === 'xcodeproj'
+        ? `${path.relative(process.cwd(), app.origin.project) || '.'} › target ${app.origin.target}`
+        : `${path.relative(process.cwd(), app.root) || '.'} (folder)`;
+    info(`${bold(app.displayName)} ${dim(`(${app.name})`)} from ${cyan(origin)}`);
+    info(dim(`  ${app.sources.length} Swift file${app.sources.length === 1 ? '' : 's'}, ${app.catalogs.length} asset catalog${app.catalogs.length === 1 ? '' : 's'}, Foundation: ${app.foundation}, Swift ${app.swiftLanguageMode} mode`));
+}
+/** Prints the import report; returns whether anything is known to be unsupported. */
+export function describeReport(report, app) {
+    let blocked = false;
+    for (const module of report.modules) {
+        const where = module.files.length === 1 ? path.basename(module.files[0]) : `${module.files.length} files`;
+        switch (module.status) {
+            case 'supported':
+                info(ok(`import ${module.module} ${dim(where)}`));
+                break;
+            case 'rewritten':
+                info(ok(`import ${module.module} ${dim(`→ ${rewrittenTo(module.module, app.foundation)} (${where})`)}`));
+                break;
+            case 'unsupported':
+                blocked = true;
+                info(bad(`import ${module.module} ${dim(where)}`));
+                if (module.hint)
+                    info(`    ${yellow(module.hint)}`);
+                break;
+            case 'unknown':
+                info(warn(`import ${module.module} ${dim(`${where}; not a module the shim provides, the build will say`)}`));
+                break;
+        }
+    }
+    const previews = [...report.previews.values()].reduce((a, b) => a + b, 0);
+    if (previews > 0)
+        info(dim(`  ${previews} #Preview block${previews === 1 ? '' : 's'} left out`));
+    if (!report.hasMain)
+        info(warn(`no @main App found among the sources of ${app.name}`));
+    return blocked;
+}
+//# sourceMappingURL=shared.js.map

package/dist/commands/shared.js.map

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

package/dist/compat.d.ts

@@ -0,0 +1,27 @@
+import type { FoundationMode } from './config.js';
+export type ModuleStatus = 'supported' | 'rewritten' | 'unsupported' | 'unknown';
+export interface ModuleReport {
+    module: string;
+    status: ModuleStatus;
+    /** Files importing it (absolute paths). */
+    files: string[];
+    /** For unsupported modules: what to do. */
+    hint?: string;
+}
+export interface CompatReport {
+    modules: ModuleReport[];
+    /** `#Preview` blocks the staging step strips, by file. */
+    previews: Map<string, number>;
+    /** Whether some file declares `@main`. */
+    hasMain: boolean;
+}
+/** The modules a Swift source imports (first path component of each import). */
+export declare function importsOf(source: string): string[];
+/** Number of `#Preview` macro uses in a source. */
+export declare function previewCount(source: string): number;
+export declare function classify(module: string, foundation: FoundationMode): ModuleStatus;
+export declare function hintFor(module: string): string | undefined;
+/** What a `rewritten` import becomes in the staging package. */
+export declare function rewrittenTo(module: string, foundation: FoundationMode): string;
+/** Scans `files` (absolute paths) and groups their imports. */
+export declare function compatReport(files: readonly string[], foundation: FoundationMode): CompatReport;

package/dist/compat.js

@@ -0,0 +1,111 @@
+// What a project imports, and how the shim treats each module: before a
+// build, so the report names the frameworks that will not compile instead of
+// a wall of unresolved-identifier errors.
+import { readFileSync } from 'node:fs';
+// The C libraries are usually behind `#if canImport(...)`; whichever branch the wasm build takes is fine.
+const SUPPORTED = new Set(['SwiftUI', 'Swift', 'Observation', 'FoundationEssentials', 'FoundationLite', 'FoundationBridge', 'Charts', 'SwiftBrowser', 'WASILibc', 'Glibc', 'Musl', 'Darwin']);
+/** Frameworks the browser has no counterpart for yet, with the usual way out. */
+const UNSUPPORTED = {
+    UIKit: 'UIKit has no browser counterpart; keep UIKit code behind `#if !SWIFTBROWSER`',
+    AppKit: 'AppKit has no browser counterpart; keep it behind `#if !SWIFTBROWSER`',
+    Combine: 'Combine is not available (`Timer.publish` + `onReceive` work without the import); use async/await, `.task` and `@Observable` for the rest',
+    SwiftData: 'SwiftData is not available; keep models in an `@Observable` store behind `#if SWIFTBROWSER`',
+    CoreData: 'Core Data is not available; keep persistence behind `#if !SWIFTBROWSER`',
+    CoreML: 'Core ML is not available; stub the model behind `#if SWIFTBROWSER`',
+    CreateML: 'Create ML is not available',
+    Vision: 'Vision is not available',
+    MapKit: 'MapKit is not available yet; show a placeholder behind `#if SWIFTBROWSER`',
+    CoreLocation: 'Core Location is not available yet',
+    AVFoundation: 'AVFoundation is not available; audio and video need a browser-side counterpart first',
+    AVKit: 'AVKit is not available',
+    UserNotifications: 'UserNotifications is not available; guard it with `#if !SWIFTBROWSER`',
+    StoreKit: 'StoreKit is not available',
+    CloudKit: 'CloudKit is not available',
+    WidgetKit: 'WidgetKit extensions do not run in the browser',
+    PhotosUI: 'PhotosUI is not available yet',
+    Photos: 'Photos is not available',
+    WebKit: 'WebKit is not available (an inline web view would be a renderer feature)',
+    CoreImage: 'Core Image is not available',
+    CoreGraphics: 'Core Graphics is only partly available (CGFloat, CGPoint, CGSize, CGRect are in the shim); remove the import',
+    QuartzCore: 'QuartzCore is not available',
+    Metal: 'Metal is not available',
+    MetalKit: 'Metal is not available',
+    SpriteKit: 'SpriteKit is not available',
+    SceneKit: 'SceneKit is not available',
+    RealityKit: 'RealityKit is not available',
+    ARKit: 'ARKit is not available',
+    GameKit: 'GameKit is not available',
+    HealthKit: 'HealthKit is not available',
+    EventKit: 'EventKit is not available',
+    Contacts: 'Contacts is not available',
+    MessageUI: 'MessageUI is not available',
+    SafariServices: 'SafariServices is not available',
+    LocalAuthentication: 'LocalAuthentication is not available',
+    Security: 'Security is not available',
+    Network: 'Network.framework is not available; use URLSession-free fetching through the host (planned)',
+    TipKit: 'TipKit is not available',
+    CodeScanner: 'CodeScanner (a camera package) is not available; simulate the scan behind `#if SWIFTBROWSER`',
+};
+const IMPORT = /^\s*(?:@[A-Za-z_]+(?:\([^)]*\))?\s+)*import\s+(?:(?:struct|class|enum|protocol|typealias|func|let|var|actor)\s+)?([A-Za-z_][A-Za-z0-9_]*)/gm;
+/** The modules a Swift source imports (first path component of each import). */
+export function importsOf(source) {
+    const out = [];
+    for (const match of source.matchAll(IMPORT))
+        out.push(match[1]);
+    return out;
+}
+/** Number of `#Preview` macro uses in a source. */
+export function previewCount(source) {
+    return (source.match(/^\s*#Preview\b/gm) ?? []).length;
+}
+export function classify(module, foundation) {
+    if (module === 'Foundation')
+        return foundation === 'lean' ? 'rewritten' : 'supported';
+    if (module === 'FoundationLite')
+        return foundation === 'full' ? 'rewritten' : 'supported';
+    if (SUPPORTED.has(module))
+        return 'supported';
+    if (module in UNSUPPORTED)
+        return 'unsupported';
+    return 'unknown';
+}
+export function hintFor(module) {
+    return UNSUPPORTED[module];
+}
+/** What a `rewritten` import becomes in the staging package. */
+export function rewrittenTo(module, foundation) {
+    if (module === 'Foundation' && foundation === 'lean')
+        return 'FoundationEssentials + FoundationLite';
+    if (module === 'FoundationLite' && foundation === 'full')
+        return 'FoundationBridge';
+    return module;
+}
+/** Scans `files` (absolute paths) and groups their imports. */
+export function compatReport(files, foundation) {
+    const byModule = new Map();
+    const previews = new Map();
+    let hasMain = false;
+    for (const file of files) {
+        const source = readFileSync(file, 'utf8');
+        if (/^\s*@main\b/m.test(source))
+            hasMain = true;
+        const count = previewCount(source);
+        if (count > 0)
+            previews.set(file, count);
+        for (const module of new Set(importsOf(source))) {
+            let report = byModule.get(module);
+            if (!report) {
+                report = { module, status: classify(module, foundation), files: [] };
+                const hint = hintFor(module);
+                if (hint)
+                    report.hint = hint;
+                byModule.set(module, report);
+            }
+            report.files.push(file);
+        }
+    }
+    const order = { unsupported: 0, unknown: 1, rewritten: 2, supported: 3 };
+    const modules = [...byModule.values()].sort((a, b) => order[a.status] - order[b.status] || a.module.localeCompare(b.module));
+    return { modules, previews, hasMain };
+}
+//# sourceMappingURL=compat.js.map

package/dist/compat.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,45 @@
+export type FoundationMode = 'lean' | 'full';
+export type SwiftLanguageMode = '5' | '6';
+export interface Config {
+    /** Module name of the app (letters, digits, `_`); defaults to the target or folder name. */
+    name?: string;
+    /** Shown on the landing page and in the home-screen manifest. */
+    displayName?: string;
+    /** The Xcode app target to build when the project has several. */
+    target?: string;
+    /** Files or directories (relative to the project) whose `.swift` files are the app's sources; replaces discovery. */
+    sources?: string[];
+    /** Files or directories (relative to the project) left out of the sources. */
+    exclude?: string[];
+    /** `*.xcassets` directories (relative to the project); replaces discovery. */
+    catalogs?: string[];
+    /**
+     * Files and folders (relative to the project) the app reads through
+     * `Bundle.main`; replaces the Xcode target's Copy Bundle Resources. A folder
+     * keeps its name (a folder reference), a file is published under its name.
+     */
+    resources?: string[];
+    /** A PNG for the home-screen icon (relative to the project). */
+    icon?: string;
+    /** Swift language mode the sources are compiled in (default 5, like Xcode's default for apps). */
+    swiftLanguageMode?: SwiftLanguageMode;
+    /**
+     * `full` (default): the wasm SDK's Foundation, nothing rewritten, its ICU
+     * data trimmed to `locales` (see below); about 19 MB optimized, 6.6 MB
+     * gzipped. `lean`: `import Foundation` is rewritten to FoundationEssentials
+     * + FoundationLite, a smaller module (4.5 to 9 MB) with a smaller API.
+     */
+    foundation?: FoundationMode;
+    /**
+     * In full mode, the languages whose ICU locale data is kept (BCP 47 tags;
+     * the region part is ignored, every regional variant of the language stays).
+     * Default `["en"]`, about 5.5 MB; `["*"]` keeps the SDK's whole 34 MB.
+     */
+    locales?: string[];
+    /** Extra `-D` compilation conditions (SWIFTBROWSER is always defined). */
+    defines?: string[];
+}
+export declare const CONFIG_FILE = "swiftbrowser.json";
+/** Reads and validates `swiftbrowser.json` in `dir` (or the file at `file`); `{}` when absent. */
+export declare function loadConfig(dir: string, file?: string): Config;
+export declare function validateConfig(raw: unknown, source?: string): Config;

package/dist/config.js

@@ -0,0 +1,70 @@
+// `swiftbrowser.json`: optional per-project settings. Everything has a
+// default worked out from the Xcode project or the folder, so most projects
+// need no file at all.
+import { existsSync, readFileSync } from 'node:fs';
+import path from 'node:path';
+import { CliError } from './log.js';
+export const CONFIG_FILE = 'swiftbrowser.json';
+const STRING_KEYS = ['name', 'displayName', 'target', 'icon'];
+const LIST_KEYS = ['sources', 'exclude', 'catalogs', 'resources', 'defines', 'locales'];
+/** Reads and validates `swiftbrowser.json` in `dir` (or the file at `file`); `{}` when absent. */
+export function loadConfig(dir, file) {
+    const configPath = file ?? path.join(dir, CONFIG_FILE);
+    if (!existsSync(configPath)) {
+        if (file)
+            throw new CliError(`config file not found: ${configPath}`);
+        return {};
+    }
+    let raw;
+    try {
+        raw = JSON.parse(readFileSync(configPath, 'utf8'));
+    }
+    catch (error) {
+        throw new CliError(`${configPath}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    return validateConfig(raw, configPath);
+}
+export function validateConfig(raw, source = CONFIG_FILE) {
+    if (typeof raw !== 'object' || raw === null || Array.isArray(raw))
+        throw new CliError(`${source}: expected a JSON object`);
+    const record = raw;
+    const config = {};
+    for (const key of STRING_KEYS) {
+        const value = record[key];
+        if (value === undefined)
+            continue;
+        if (typeof value !== 'string')
+            throw new CliError(`${source}: "${key}" must be a string`);
+        config[key] = value;
+    }
+    for (const key of LIST_KEYS) {
+        const value = record[key];
+        if (value === undefined)
+            continue;
+        if (!Array.isArray(value) || !value.every((v) => typeof v === 'string'))
+            throw new CliError(`${source}: "${key}" must be an array of strings`);
+        config[key] = value;
+    }
+    if (record['swiftLanguageMode'] !== undefined) {
+        const mode = String(record['swiftLanguageMode']);
+        if (mode !== '5' && mode !== '6')
+            throw new CliError(`${source}: "swiftLanguageMode" must be "5" or "6"`);
+        config.swiftLanguageMode = mode;
+    }
+    if (record['foundation'] !== undefined) {
+        const mode = record['foundation'];
+        if (mode !== 'lean' && mode !== 'full')
+            throw new CliError(`${source}: "foundation" must be "lean" or "full"`);
+        config.foundation = mode;
+    }
+    if (config.name !== undefined && !/^[A-Za-z_][A-Za-z0-9_]*$/.test(config.name)) {
+        throw new CliError(`${source}: "name" must be a Swift module name (letters, digits, underscores)`);
+    }
+    for (const key of Object.keys(record)) {
+        if (!STRING_KEYS.includes(key) && !LIST_KEYS.includes(key) && key !== 'swiftLanguageMode' && key !== 'foundation' && key !== '$schema') {
+            throw new CliError(`${source}: unknown key "${key}"`);
+        }
+    }
+    return config;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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