@stag-build/phonebook 0.1.0

package/dist/scan/ios.js

@@ -0,0 +1,201 @@
+import { readdir, readFile } from 'node:fs/promises';
+import { join, relative } from 'node:path';
+import { previewHints } from './hints.js';
+/**
+ * Regex-based heuristic scanner for SwiftUI `View` structs and `#Preview`
+ * macros (plus legacy `PreviewProvider` structs). Walks the project tree and
+ * matches previews to components by file + name heuristics.
+ */
+export async function scanIos(projectDir) {
+    const components = [];
+    const orphanPreviews = [];
+    const files = await walkSwiftFiles(projectDir);
+    for (const file of files) {
+        const relFile = relative(projectDir, file);
+        const content = await readFile(file, 'utf8');
+        const fileComponents = findViewStructs(content, relFile);
+        const filePreviews = findPreviews(content, relFile);
+        for (const comp of fileComponents)
+            components.push(comp);
+        matchPreviewsToComponents(filePreviews, fileComponents, orphanPreviews);
+    }
+    components.sort((a, b) => a.file.localeCompare(b.file) || a.line - b.line);
+    orphanPreviews.sort((a, b) => a.file.localeCompare(b.file) || a.line - b.line);
+    return {
+        platform: 'ios',
+        components,
+        orphanPreviews,
+        stats: computeStats(components, orphanPreviews),
+    };
+}
+function findViewStructs(content, relFile) {
+    const results = [];
+    const regex = /(?:struct|final class)\s+([A-Z]\w*)\s*:\s*[^{]*\bView\b/g;
+    let match;
+    while ((match = regex.exec(content)) !== null) {
+        results.push({
+            name: match[1],
+            file: relFile,
+            line: lineNumberAt(content, match.index),
+            previews: [],
+        });
+    }
+    return results;
+}
+function findPreviews(content, relFile) {
+    const results = [];
+    // #Preview("Name", traits: ...) { ... }
+    const previewRegex = /#Preview\s*(\(([^)]*)\))?/g;
+    let match;
+    while ((match = previewRegex.exec(content)) !== null) {
+        const argsText = match[2] ?? '';
+        const nameMatch = argsText.match(/"([^"]*)"/);
+        const displayName = nameMatch ? nameMatch[1] : undefined;
+        const line = lineNumberAt(content, match.index);
+        const dark = isDarkPreview(content, match.index, displayName);
+        const annotationText = extractAnnotationText(content, match.index);
+        const functionName = displayName ?? 'unnamed';
+        const hints = previewHints({
+            platform: 'ios',
+            functionName,
+            displayName,
+            annotationText,
+        });
+        results.push({
+            name: functionName,
+            ...(displayName !== undefined ? { displayName } : {}),
+            file: relFile,
+            line,
+            dark,
+            annotationText,
+            ...(hints.length > 0 ? { hints } : {}),
+        });
+    }
+    // Legacy: struct X_Previews: PreviewProvider
+    const legacyRegex = /struct\s+(\w+)_Previews\s*:\s*PreviewProvider/g;
+    while ((match = legacyRegex.exec(content)) !== null) {
+        results.push({
+            name: `${match[1]}_Previews`,
+            file: relFile,
+            line: lineNumberAt(content, match.index),
+            dark: false,
+        });
+    }
+    return results;
+}
+/** True when the ~10 lines following a #Preview declaration set a dark color scheme. */
+function isDarkPreview(content, matchIndex, displayName) {
+    if (displayName && displayName.endsWith('Dark'))
+        return true;
+    const rest = content.slice(matchIndex);
+    const restLines = rest.split('\n');
+    // Stop at the next #Preview / preview-provider struct so we don't bleed into it.
+    const boundary = restLines.findIndex((l, i) => i > 0 && (/#Preview\b/.test(l) || /:\s*PreviewProvider\b/.test(l)));
+    const window = boundary === -1 ? restLines.slice(0, 11) : restLines.slice(0, Math.min(11, boundary));
+    return /\.preferredColorScheme\(\s*\.dark\s*\)/.test(window.join('\n'));
+}
+/** The #Preview(...) line plus the following lines of its body, up to the next
+ * #Preview/PreviewProvider or ~15 lines, whichever comes first. */
+function extractAnnotationText(content, matchIndex) {
+    const rest = content.slice(matchIndex);
+    const restLines = rest.split('\n');
+    const boundary = restLines.findIndex((l, i) => i > 0 && (/#Preview\b/.test(l) || /:\s*PreviewProvider\b/.test(l)));
+    const cap = 15;
+    const limit = boundary === -1 ? cap : Math.min(cap, boundary);
+    return restLines.slice(0, limit).join('\n');
+}
+function lineNumberAt(content, index) {
+    let line = 1;
+    for (let i = 0; i < index; i++) {
+        if (content[i] === '\n')
+            line++;
+    }
+    return line;
+}
+/**
+ * Matches previews to components within the same file:
+ * 1. A "Component/State" display name matches a component by name
+ *    (case/space-insensitive).
+ * 2. A legacy `X_Previews` preview matches component `X` directly.
+ * 3. Otherwise: the single component in the file if there is exactly one,
+ *    else the nearest component declared above the preview, else orphan.
+ */
+function matchPreviewsToComponents(previews, components, orphanPreviews) {
+    for (const preview of previews) {
+        let target;
+        const legacyMatch = preview.name.match(/^(\w+)_Previews$/);
+        if (legacyMatch) {
+            target = components.find((c) => c.name === legacyMatch[1]);
+        }
+        if (!target && preview.displayName?.includes('/')) {
+            const componentPart = preview.displayName.slice(0, preview.displayName.indexOf('/'));
+            target = components.find((c) => normalize(c.name) === normalize(componentPart));
+        }
+        if (!target) {
+            if (components.length === 1) {
+                target = components[0];
+            }
+            else if (components.length > 1) {
+                // Nearest component declared above the preview.
+                const above = components.filter((c) => c.line <= preview.line);
+                if (above.length > 0) {
+                    target = above.reduce((a, b) => (b.line > a.line ? b : a));
+                }
+            }
+        }
+        if (target) {
+            target.previews.push(preview);
+        }
+        else {
+            orphanPreviews.push(preview);
+        }
+    }
+}
+function normalize(name) {
+    return name.replace(/\s+/g, '').toLowerCase();
+}
+function computeStats(components, orphanPreviews) {
+    const withPreview = components.filter((c) => c.previews.length > 0).length;
+    const withDarkPreview = components.filter((c) => c.previews.some((p) => p.dark)).length;
+    const totalPreviews = components.reduce((sum, c) => sum + c.previews.length, 0) + orphanPreviews.length;
+    const allPreviews = [...components.flatMap((c) => c.previews), ...orphanPreviews];
+    const hintCount = allPreviews.reduce((sum, p) => sum + (p.hints?.length ?? 0), 0);
+    // Unlike Android's @Preview (which annotates the composable itself), #Preview is
+    // always a separate top-level block, so a SwiftUI View struct can't be its own
+    // preview. No self-preview pattern exists here.
+    return {
+        components: components.length,
+        withPreview,
+        withDarkPreview,
+        totalPreviews,
+        hintCount,
+        selfPreviewed: 0,
+    };
+}
+const SKIP_DIRS = new Set(['build', '.build', 'DerivedData', 'Pods']);
+async function walkSwiftFiles(dir) {
+    const results = [];
+    let entries;
+    try {
+        entries = await readdir(dir, { withFileTypes: true });
+    }
+    catch {
+        return results;
+    }
+    for (const entry of entries) {
+        if (entry.isDirectory()) {
+            if (SKIP_DIRS.has(entry.name))
+                continue;
+            if (entry.name.endsWith('.xcodeproj'))
+                continue;
+            if (entry.name.includes('Test'))
+                continue;
+            results.push(...(await walkSwiftFiles(join(dir, entry.name))));
+        }
+        else if (entry.isFile() && entry.name.endsWith('.swift')) {
+            results.push(join(dir, entry.name));
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=ios.js.map

package/dist/scan/ios.js.map

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

package/dist/scan/types.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Coverage scanning: heuristic, regex-based discovery of UI components and the
+ * previews that cover them. Used by the MCP `analyze_coverage` tool so an agent
+ * can find components with missing previews/states and add them as code.
+ */
+import type { PreviewHint } from './hints.js';
+export type { PreviewHint };
+export interface ScannedPreview {
+    /** Preview function name (Android) or #Preview display name / "unnamed" (iOS) */
+    name: string;
+    /** Display name from @Preview(name=...) / #Preview("...") when present */
+    displayName?: string;
+    file: string;
+    line: number;
+    /** True when the preview declares a dark configuration (uiMode NIGHT / .dark) */
+    dark: boolean;
+    /** Raw annotation/macro text as written in source (Android: @Preview(...) annotations
+     * joined; iOS: the #Preview(...) line plus the following lines of its body, capped). */
+    annotationText?: string;
+    /** Text of the preview function's body (from the opening brace, capped to ~20 lines).
+     * Lets hints inspect what the composable actually does, e.g. a fixed-size Modifier
+     * that can't substitute for an annotation-level canvas size. */
+    bodyText?: string;
+    /** Configuration hints: cases where the preview's name implies a trait its
+     * annotation doesn't declare. See src/scan/hints.ts. */
+    hints?: PreviewHint[];
+}
+export interface ScannedComponent {
+    /** Composable function name (Android) or View struct name (iOS) */
+    name: string;
+    file: string;
+    line: number;
+    /** Previews matched to this component (same file + name-prefix heuristic) */
+    previews: ScannedPreview[];
+}
+export interface CoverageReport {
+    platform: 'android' | 'ios';
+    components: ScannedComponent[];
+    /** Previews that could not be matched to any discovered component */
+    orphanPreviews: ScannedPreview[];
+    /** Totals for a quick summary */
+    stats: {
+        components: number;
+        withPreview: number;
+        withDarkPreview: number;
+        totalPreviews: number;
+        hintCount: number;
+        /** Components whose only preview is themselves (the @Preview-on-the-composable
+         * pattern for screen-level composables with default parameters). */
+        selfPreviewed: number;
+    };
+}

package/dist/scan/types.js

@@ -0,0 +1,7 @@
+/**
+ * Coverage scanning: heuristic, regex-based discovery of UI components and the
+ * previews that cover them. Used by the MCP `analyze_coverage` tool so an agent
+ * can find components with missing previews/states and add them as code.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/scan/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/scan/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/site/build.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Build a static, self-contained gallery site from a phonebook bundle.
+ *
+ * Reads `<bundleDir>/manifest.json` and writes `<outDir>/index.html`.
+ *
+ * By default (or when `options.inPlace` is set), the site is written directly
+ * into the bundle directory, reusing the images already there under
+ * `images/` — nothing is copied. Pass `options.inPlace: false` (which is
+ * implied automatically whenever `outDir` differs from `bundleDir`) to copy
+ * `<bundleDir>/images` into `<outDir>/images` instead, producing a standalone
+ * site directory independent of the bundle.
+ *
+ * Returns the number of screenshot entries in the manifest.
+ */
+export declare function buildSite(bundleDir: string, outDir: string, options?: {
+    inPlace?: boolean;
+}): Promise<number>;

package/dist/site/build.js.map

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

package/dist/versions.d.ts

@@ -0,0 +1,71 @@
+export interface KotlinVersion {
+    major: number;
+    minor: number;
+    patch: number;
+}
+/** Parses a "X.Y[.Z]" version string. */
+export declare function parseKotlinVersion(s: string): KotlinVersion | undefined;
+/**
+ * Detects the project's Kotlin (compiler) version by searching, in order:
+ * gradle/libs.versions.toml, root build.gradle.kts/build.gradle, and
+ * settings.gradle.kts/settings.gradle (pluginManagement plugins block).
+ * Returns the first hit, with `source` set to the file it came from
+ * (relative to `projectDir`).
+ */
+export declare function detectKotlinVersion(projectDir: string): Promise<{
+    version: KotlinVersion;
+    source: string;
+} | undefined>;
+/**
+ * Whether a Kotlin compiler `K.M.*` can read metadata written by a compiler
+ * whose binary metadata version is `(a, b[, c])`: (a, b) <= (K, M+1).
+ * Special case: metadata (1, 9, 9999) means "pinned to language version 1.9"
+ * and is readable by any compiler >= 1.9.
+ */
+export declare function canRead(compiler: {
+    major: number;
+    minor: number;
+}, metadata: [number, number, number?]): boolean;
+/** Finds and decompresses a single zip entry whose name satisfies `matches`. */
+export declare function readZipEntry(buf: Buffer, matches: (name: string) => boolean): Buffer | undefined;
+/**
+ * Fetches an artifact's real Kotlin metadata version straight from its
+ * bytecode (not its POM, which can lie): tries the .aar first (containing
+ * classes.jar), falling back to a plain .jar on 404.
+ */
+export declare function fetchKotlinMetadataVersion(group: string, artifact: string, version: string): Promise<[number, number, number] | undefined>;
+/** Lists released (non-alpha/rc) versions of a Maven artifact, oldest first. */
+export declare function listMavenVersions(group: string, artifact: string): Promise<string[]>;
+interface FallbackRange {
+    /** Inclusive [low, high] version range this metadata applies to. */
+    range: [string, string];
+    metadata: [number, number, number];
+}
+/**
+ * Known Kotlin-metadata ranges, probed empirically on 2026-08-22 by fetching
+ * each artifact's real bytecode (its POM understates Kotlin requirements).
+ * Used to skip network probes in resolveMaxCompatible, and as a last resort
+ * when the network is unavailable.
+ */
+export declare const FALLBACK: Record<string, FallbackRange[]>;
+/** Looks up an artifact version's Kotlin metadata in the FALLBACK table, if known. */
+export declare function lookupFallbackMetadata(group: string, artifact: string, version: string): [number, number, number] | undefined;
+export interface ResolveResult {
+    /** Highest version compatible with the detected Kotlin compiler, if any. */
+    best?: string;
+    /** Newest released version, regardless of compatibility. */
+    latest?: string;
+    /** Minimum Kotlin compiler ("major.minor") the `latest` version needs. */
+    latestNeedsKotlin?: string;
+}
+/**
+ * Finds the newest version of `group:artifact` compatible with `kotlin`, by
+ * walking released versions from newest to oldest (capped at 15 network
+ * probes) checking real Kotlin metadata, seeded by FALLBACK to skip probing
+ * known ranges.
+ */
+export declare function resolveMaxCompatible(group: string, artifact: string, kotlin: {
+    major: number;
+    minor: number;
+}): Promise<ResolveResult>;
+export {};